@harness-nexus/cli 0.1.0-alpha.1

package/dist/install/adapters/codex.js

@@ -0,0 +1,172 @@
+/**
+ * Codex target adapter (Phase 8 C2 — lands here as the "trivial case" of the
+ * stdio shim unification; absorbs roadmap 3.6).
+ *
+ * Codex layout (ground truth: `docs/research/phase-3-ecc-install-patterns.md`
+ * § "Codex — concrete format"):
+ *   A. skills      → `~/.codex/skills/<name>/SKILL.md` (+ bundle files)
+ *   B. commands    → `~/.codex/prompts/<name>.md` (YAML frontmatter stripped)
+ *   C. MCP         → TOML `~/.codex/config.toml` `[mcp_servers.*]` sections —
+ *                    **stdio-only** (Codex refuses `url` keys), which is exactly
+ *                    what the `hnx mcp serve` shim entry is.
+ *
+ * Deferred (unverified home-install shapes): rules (Codex wants AGENTS.md at a
+ * PROJECT root; a global write is not established), sub_agents, hooks — all
+ * surface as skipped warnings.
+ *
+ * The TOML merge is add/overwrite-only text surgery (like ECC's
+ * merge-mcp-config.js): our `[mcp_servers.harness-nexus-<slug>]` section is
+ * replaced idempotently; every other byte of the user's config is preserved.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createTargetAdapter } from '../adapter-factory.js';
+import { hnxExecutablePath } from '../../config.js';
+/** The install-state ledger filename inside the Codex home. */
+const INSTALL_STATE_FILENAME = 'harness-nexus-install-state.json';
+/** A resource kind this adapter cannot emit (yet). */
+const SKIPPED_KINDS = new Set(['rule', 'sub_agent', 'hook']);
+const SKIP_REASONS = {
+    rule: 'Codex rules live in a project-root AGENTS.md — global install shape unverified',
+    sub_agent: 'Codex has no file-based sub-agent format',
+    hook: 'Codex has no declarative hooks format',
+};
+function slugify(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64) || 'harness-nexus-profile');
+}
+// ---- TOML text surgery (no TOML parser dependency — our payload is plain) ----
+/** JSON string escaping is valid TOML basic-string escaping for our charset. */
+function tomlString(value) {
+    return JSON.stringify(value);
+}
+/**
+ * Replace (or append) one `[section]` in a TOML document, preserving every
+ * other line. Re-running with the same section is idempotent — an overwrite,
+ * unlike ECC's strictly add-only merge, matching our "plans are idempotent
+ * overwrites" upgrade semantics.
+ */
+export function mergeTomlSection(existing, section, body) {
+    const headerRe = /^\s*\[[^\]]+\]\s*$/;
+    const target = `[${section}]`;
+    const kept = [];
+    let skipping = false;
+    for (const line of existing.split('\n')) {
+        if (headerRe.test(line))
+            skipping = line.trim() === target;
+        if (!skipping)
+            kept.push(line);
+    }
+    const base = kept.join('\n').replace(/\s+$/, '');
+    return `${base}${base.length > 0 ? '\n\n' : ''}${target}\n${body}`;
+}
+/** Serialize the shim entry's `[mcp_servers.<key>]` body. */
+function shimSectionBody(resolved, serverBase) {
+    const args = ['mcp', 'serve', '--profile', resolved.profile.id, '--server', serverBase];
+    return [
+        `command = ${tomlString(hnxExecutablePath())}`,
+        `args = [${args.map(tomlString).join(', ')}]`,
+    ].join('\n');
+}
+/** Strip a leading YAML frontmatter block (Codex prompts are plain markdown). */
+function stripFrontmatter(content) {
+    if (!content.startsWith('---\n'))
+        return content;
+    const end = content.indexOf('\n---\n', 4);
+    if (end === -1)
+        return content;
+    return content.slice(end + 5);
+}
+/** Extract a Resource's inline file set (same policy as the Hermes adapter). */
+function resourceFiles(artifact) {
+    if (artifact.kind === 'mcp')
+        return [];
+    const src = artifact.resource.source;
+    if (src.type === 'inline') {
+        return [{ relativePath: 'SKILL.md', content: src.content }];
+    }
+    if (src.type === 'inline-bundle') {
+        return Object.entries(src.files).map(([rel, content]) => ({ relativePath: rel, content }));
+    }
+    return [];
+}
+export const codexAdapter = createTargetAdapter({
+    id: 'codex-home',
+    target: 'codex',
+    kind: 'home',
+    rootSegments: ['.codex'],
+    planOperations(resolved, input, adapter) {
+        const root = adapter.resolveRoot(input);
+        const slug = slugify(resolved.profile.name);
+        const operations = [];
+        const skipped = [];
+        // ---- A. skills → ~/.codex/skills/<name>/ ----
+        for (const a of resolved.artifacts) {
+            if (a.kind !== 'skill')
+                continue;
+            const files = resourceFiles(a);
+            if (files.length === 0) {
+                skipped.push(`skill:${a.resource.key} (non-inline source not fetchable by CLI)`);
+                continue;
+            }
+            for (const f of files) {
+                operations.push({
+                    kind: 'write-file',
+                    content: f.content,
+                    destinationPath: path.join(root, 'skills', a.resource.name, f.relativePath),
+                });
+            }
+        }
+        // ---- B. commands → ~/.codex/prompts/<name>.md ----
+        for (const a of resolved.artifacts) {
+            if (a.kind !== 'command')
+                continue;
+            const files = resourceFiles(a);
+            const content = files[0]?.content;
+            if (content === undefined) {
+                skipped.push(`command:${a.resource.key} (non-inline source not fetchable by CLI)`);
+                continue;
+            }
+            operations.push({
+                kind: 'write-file',
+                content: stripFrontmatter(content),
+                destinationPath: path.join(root, 'prompts', `${a.resource.name}.md`),
+            });
+        }
+        // ---- C. MCP → config.toml [mcp_servers.harness-nexus-<slug>] ----
+        const serverBase = process.env.HN_SERVER ?? 'https://harness-nexus.example.com';
+        const hasMcp = resolved.artifacts.some((a) => a.kind === 'mcp');
+        let needsHnx = false;
+        if (hasMcp) {
+            const cfgPath = path.join(root, 'config.toml');
+            const existing = fs.existsSync(cfgPath) ? fs.readFileSync(cfgPath, 'utf8') : '';
+            const merged = mergeTomlSection(existing, `mcp_servers.harness-nexus-${slug}`, shimSectionBody(resolved, serverBase));
+            operations.push({ kind: 'write-file', content: merged, destinationPath: cfgPath });
+            needsHnx = true;
+        }
+        // ---- skipped kinds ----
+        for (const a of resolved.artifacts) {
+            if (a.kind === 'mcp')
+                continue;
+            if (SKIPPED_KINDS.has(a.kind)) {
+                skipped.push(`${a.kind}:${a.resource.key} (${SKIP_REASONS[a.kind]})`);
+            }
+        }
+        lastPlanWarnings = { skipped, needsHnx };
+        return {
+            adapter: { id: adapter.id, target: adapter.target, kind: adapter.kind },
+            targetRoot: root,
+            installStatePath: path.join(root, INSTALL_STATE_FILENAME),
+            operations,
+            sensitive: false,
+        };
+    },
+});
+let lastPlanWarnings = { skipped: [], needsHnx: false };
+export function getCodexPlanWarnings() {
+    return lastPlanWarnings;
+}
+//# sourceMappingURL=codex.js.map

package/dist/install/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/install/adapters/codex.ts"],"names":[],"mappings":"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"}

package/dist/install/adapters/deepseek.d.ts

@@ -0,0 +1,26 @@
+import type { ResolvedProfile, TargetAdapter } from '../types.js';
+/**
+ * Guarantee the frontmatter dsh requires. Existing frontmatter lines are kept
+ * verbatim (dsh tolerates extra metadata keys); only `name` (must be kebab)
+ * and `description` (non-empty) are completed or corrected. JSON string
+ * quoting is valid YAML 1.2 double-quoting — the escape hatch for arbitrary
+ * description text.
+ */
+export declare function ensureDshFrontmatter(content: string, slug: string, description: string): string;
+/**
+ * Replace (or append) this profile's managed region in the home patch,
+ * preserving every other byte — including other profiles' regions. Re-running
+ * with the same slug is idempotent, matching "plans are idempotent
+ * overwrites" upgrade semantics.
+ */
+export declare function mergeManagedPatchRegion(existing: string, slug: string, block: string): string;
+/** Serialize this profile's `- insert:` block for the home patch. */
+export declare function managedPatchBlock(resolved: ResolvedProfile, serverBase: string): string;
+export declare const deepseekAdapter: TargetAdapter;
+/** Warnings from the most recent deepseek plan (read by the CLI for output). */
+export interface DeepseekPlanWarnings {
+    skipped: string[];
+    needsHnx: boolean;
+}
+export declare function getDeepseekPlanWarnings(): DeepseekPlanWarnings;
+//# sourceMappingURL=deepseek.d.ts.map

package/dist/install/adapters/deepseek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../../src/install/adapters/deepseek.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAA+B,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuD/F;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAyB/F;AAOD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAa7F;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAevF;AAeD,eAAO,MAAM,eAAe,EAAE,aAyF5B,CAAC;AAEH,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D"}

package/dist/install/adapters/deepseek.js

@@ -0,0 +1,246 @@
+/**
+ * DeepSeek Harness (dsh) target adapter (Phase 8 T1).
+ *
+ * dsh layout (ground truth: `docs/research/phase-8-t1-deepseek-harness.md`,
+ * pinned to dsh v0.1.2-rc.1):
+ *   A. skills   → `~/.dsh/skills/<name>/SKILL.md` (+ bundle files) — the Agent
+ *                 Skills format, but dsh REQUIRES YAML frontmatter
+ *                 `name` + `description` (files without it are ignored) and
+ *                 kebab-case names `^[a-z0-9]+(?:-[a-z0-9]+)*$`; the adapter
+ *                 guarantees both (frontmatter synthesis).
+ *   B. commands → flat `~/.dsh/skills/<name>.md` — dsh's slash-command
+ *                 surface IS the skill surface (`/name`); frontmatter is kept
+ *                 and completed, unlike the Codex adapter which strips it.
+ *   C. MCP      → home-level `~/.dsh/cordis.patch.yml` — a managed
+ *                 `- insert:` row per profile mounting
+ *                 `'@deepseek-ai/dsh-mcp-client'` with the stdio
+ *                 `hnx mcp serve` shim. The row sits between per-profile
+ *                 marker comments; re-planning replaces only THIS profile's
+ *                 marked region (idempotent overwrite — other profiles'
+ *                 regions and user rows stay byte-for-byte), and dsh
+ *                 hot-reloads the home patch without a restart.
+ *
+ * Deferred (no verified declarative shape — see research): rules (the dsh
+ * persona is a config row; overwriting a user's is destructive), sub_agents
+ * (programmatic provider registry), hooks (CC/Codex bridges are opt-in
+ * packages) — all surface as skipped warnings.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createTargetAdapter } from '../adapter-factory.js';
+import { hnxExecutablePath } from '../../config.js';
+/** The install-state ledger filename inside the dsh home. */
+const INSTALL_STATE_FILENAME = 'harness-nexus-install-state.json';
+/** dsh home patch file — applied to EVERY profile and hot-reloaded live. */
+const PATCH_FILENAME = 'cordis.patch.yml';
+/** dsh `serverName` constraint: `[A-Za-z0-9_-]{1,32}`. */
+const MAX_SERVER_NAME = 32;
+const SERVER_NAME_PREFIX = 'harness-nexus';
+/** A resource kind this adapter cannot emit (yet). */
+const SKIPPED_KINDS = new Set(['rule', 'sub_agent', 'hook']);
+const SKIP_REASONS = {
+    rule: 'dsh has no user-scope rules file — the persona is a config row hnx will not overwrite',
+    sub_agent: 'dsh sub-agents are programmatic providers, not files',
+    hook: 'dsh hook bridges are opt-in per-profile packages an install cannot wire',
+};
+/** dsh skill names are kebab-case `^[a-z0-9]+(?:-[a-z0-9]+)*$`. */
+const KEBAB_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function slugify(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/-{2,}/g, '-')
+        .slice(0, 64);
+    return slug === '' ? 'harness-nexus' : slug;
+}
+/** Cap a `harness-nexus-<slug>` server name to dsh's 32-char constraint. */
+function serverNameFor(slug) {
+    return `${SERVER_NAME_PREFIX}-${slug}`.slice(0, MAX_SERVER_NAME);
+}
+// ---- frontmatter (dsh ignores skill files without name + description) ----
+function splitFrontmatter(content) {
+    const lines = content.split('\n');
+    if (lines[0] === undefined || lines[0].trim() !== '---')
+        return null;
+    const end = lines.findIndex((l, i) => i > 0 && l.trim() === '---');
+    if (end === -1)
+        return null;
+    return { lines: lines.slice(1, end), body: lines.slice(end + 1).join('\n') };
+}
+/** Value of a `key: value` scalar line, surrounding quotes stripped. */
+function scalarValue(line, key) {
+    const v = line.slice(key.length + 1).trim();
+    return v.replace(/^['"]|['"]$/g, '');
+}
+/**
+ * Guarantee the frontmatter dsh requires. Existing frontmatter lines are kept
+ * verbatim (dsh tolerates extra metadata keys); only `name` (must be kebab)
+ * and `description` (non-empty) are completed or corrected. JSON string
+ * quoting is valid YAML 1.2 double-quoting — the escape hatch for arbitrary
+ * description text.
+ */
+export function ensureDshFrontmatter(content, slug, description) {
+    const fallback = JSON.stringify(description.trim().split('\n')[0] || slug);
+    const fm = splitFrontmatter(content);
+    if (fm === null) {
+        return `---\nname: ${slug}\ndescription: ${fallback}\n---\n\n${content}`;
+    }
+    const lines = [...fm.lines];
+    const nameIdx = lines.findIndex((l) => /^name:/.test(l));
+    if (nameIdx === -1) {
+        lines.unshift(`name: ${slug}`);
+    }
+    else if (!KEBAB_NAME.test(scalarValue(lines[nameIdx], 'name'))) {
+        lines[nameIdx] = `name: ${slug}`;
+    }
+    const descIdx = lines.findIndex((l) => /^description:/.test(l));
+    if (descIdx === -1) {
+        const afterName = lines.findIndex((l) => /^name:/.test(l)) + 1;
+        lines.splice(afterName, 0, `description: ${fallback}`);
+    }
+    else if (scalarValue(lines[descIdx], 'description') === '') {
+        // Block indicators (`>-`, `|`) count as present — only truly empty loses.
+        lines[descIdx] = `description: ${fallback}`;
+    }
+    return `---\n${lines.join('\n')}\n---\n${fm.body}`;
+}
+// ---- cordis patch surgery (per-profile managed region, no YAML parser) ----
+const beginMarker = (slug) => `# BEGIN harness-nexus:${slug} (managed)`;
+const endMarker = (slug) => `# END harness-nexus:${slug} (managed)`;
+/**
+ * Replace (or append) this profile's managed region in the home patch,
+ * preserving every other byte — including other profiles' regions. Re-running
+ * with the same slug is idempotent, matching "plans are idempotent
+ * overwrites" upgrade semantics.
+ */
+export function mergeManagedPatchRegion(existing, slug, block) {
+    const begin = beginMarker(slug);
+    const end = endMarker(slug);
+    let base = existing;
+    const b = base.indexOf(begin);
+    if (b !== -1) {
+        const e = base.indexOf(end, b);
+        if (e !== -1) {
+            base = base.slice(0, b) + base.slice(e + end.length).replace(/^\n+/, '');
+        }
+    }
+    base = base.replace(/\s+$/, '');
+    return `${base}${base.length > 0 ? '\n\n' : ''}${block}\n`;
+}
+/** Serialize this profile's `- insert:` block for the home patch. */
+export function managedPatchBlock(resolved, serverBase) {
+    const slug = slugify(resolved.profile.name);
+    const args = ['mcp', 'serve', '--profile', resolved.profile.id, '--server', serverBase];
+    return [
+        `${beginMarker(slug)} — rewritten by hnx; keep edits outside the markers`,
+        `- insert:`,
+        `    - id: hnx-mcp-${slug}`,
+        `      name: '@deepseek-ai/dsh-mcp-client'`,
+        `      config:`,
+        `        serverName: ${serverNameFor(slug)}`,
+        `        transport: stdio`,
+        `        command: ${JSON.stringify(hnxExecutablePath())}`,
+        `        args: [${args.map((a) => JSON.stringify(a)).join(', ')}]`,
+        endMarker(slug),
+    ].join('\n');
+}
+/** Extract a Resource's inline file set (same policy as the other adapters). */
+function resourceFiles(artifact) {
+    if (artifact.kind === 'mcp')
+        return [];
+    const src = artifact.resource.source;
+    if (src.type === 'inline') {
+        return [{ relativePath: 'SKILL.md', content: src.content }];
+    }
+    if (src.type === 'inline-bundle') {
+        return Object.entries(src.files).map(([rel, content]) => ({ relativePath: rel, content }));
+    }
+    return [];
+}
+export const deepseekAdapter = createTargetAdapter({
+    id: 'deepseek-home',
+    target: 'deepseek',
+    kind: 'home',
+    rootSegments: ['.dsh'],
+    planOperations(resolved, input, adapter) {
+        const root = adapter.resolveRoot(input);
+        const operations = [];
+        const skipped = [];
+        // ---- A. skills → ~/.dsh/skills/<name>/ (+ bundle files) ----
+        for (const a of resolved.artifacts) {
+            if (a.kind !== 'skill')
+                continue;
+            const files = resourceFiles(a);
+            if (files.length === 0) {
+                skipped.push(`skill:${a.resource.key} (non-inline source not fetchable by CLI)`);
+                continue;
+            }
+            const slug = slugify(a.resource.name);
+            const description = a.resource.description ?? a.resource.name;
+            if (!files.some((f) => f.relativePath === 'SKILL.md')) {
+                skipped.push(`skill:${a.resource.key} (bundle has no SKILL.md at root)`);
+                continue;
+            }
+            for (const f of files) {
+                const content = f.relativePath === 'SKILL.md'
+                    ? ensureDshFrontmatter(f.content, slug, description)
+                    : f.content;
+                operations.push({
+                    kind: 'write-file',
+                    content,
+                    destinationPath: path.join(root, 'skills', slug, f.relativePath),
+                });
+            }
+        }
+        // ---- B. commands → flat ~/.dsh/skills/<name>.md (the /name surface) ----
+        for (const a of resolved.artifacts) {
+            if (a.kind !== 'command')
+                continue;
+            const files = resourceFiles(a);
+            const content = files[0]?.content;
+            if (content === undefined) {
+                skipped.push(`command:${a.resource.key} (non-inline source not fetchable by CLI)`);
+                continue;
+            }
+            const slug = slugify(a.resource.name);
+            operations.push({
+                kind: 'write-file',
+                content: ensureDshFrontmatter(content, slug, a.resource.description ?? a.resource.name),
+                destinationPath: path.join(root, 'skills', `${slug}.md`),
+            });
+        }
+        // ---- C. MCP → home cordis.patch.yml managed region ----
+        const serverBase = process.env.HN_SERVER ?? 'https://harness-nexus.example.com';
+        const hasMcp = resolved.artifacts.some((a) => a.kind === 'mcp');
+        let needsHnx = false;
+        if (hasMcp) {
+            const patchPath = path.join(root, PATCH_FILENAME);
+            const existing = fs.existsSync(patchPath) ? fs.readFileSync(patchPath, 'utf8') : '';
+            const merged = mergeManagedPatchRegion(existing, slugify(resolved.profile.name), managedPatchBlock(resolved, serverBase));
+            operations.push({ kind: 'write-file', content: merged, destinationPath: patchPath });
+            needsHnx = true;
+        }
+        // ---- skipped kinds ----
+        for (const a of resolved.artifacts) {
+            if (a.kind === 'mcp')
+                continue;
+            if (SKIPPED_KINDS.has(a.kind)) {
+                skipped.push(`${a.kind}:${a.resource.key} (${SKIP_REASONS[a.kind]})`);
+            }
+        }
+        lastPlanWarnings = { skipped, needsHnx };
+        return {
+            adapter: { id: adapter.id, target: adapter.target, kind: adapter.kind },
+            targetRoot: root,
+            installStatePath: path.join(root, INSTALL_STATE_FILENAME),
+            operations,
+            sensitive: false,
+        };
+    },
+});
+let lastPlanWarnings = { skipped: [], needsHnx: false };
+export function getDeepseekPlanWarnings() {
+    return lastPlanWarnings;
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/install/adapters/deepseek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../../src/install/adapters/deepseek.ts"],"names":[],"mappings":"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"}

package/dist/install/adapters/hermes.d.ts

@@ -0,0 +1,16 @@
+import type { TargetAdapter } from '../types.js';
+/**
+ * The Hermes adapter. Overrides `planOperations` to emit the plugin bundle,
+ * the config.yaml MCP merge, and the AGENTS.md rule file.
+ */
+export declare const hermesAdapter: TargetAdapter;
+/** Warnings from the most recent hermes planInstall (read by the CLI for output). */
+export interface HermesPlanWarnings {
+    skipped: string[];
+    /** True when the plan carries a `hnx mcp serve` shim entry. */
+    needsHnx: boolean;
+    pluginSlug: string;
+    needsPluginEnable: boolean;
+}
+export declare function getHermesPlanWarnings(): HermesPlanWarnings;
+//# sourceMappingURL=hermes.d.ts.map

package/dist/install/adapters/hermes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../../../src/install/adapters/hermes.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAMV,aAAa,EACd,MAAM,aAAa,CAAC;AAsIrB;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aAuH1B,CAAC;AAEH,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAOD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D"}