@moreih29/nexus-core 0.17.0 → 0.18.2

package/dist/opencode/src/agents/writer.ts

@@ -1,121 +0,0 @@
-// Auto-generated by build-agents.ts — do not edit
-// Source: assets/agents/writer/body.md
-import type { AgentConfig } from "@moreih29/nexus-core/types";
-
-export const writer: AgentConfig = {
-  id: "writer",
-  name: "writer",
-  description: `Technical writing — transforms research findings, code, and analysis into clear documents and presentations for the intended audience`,
-  permission: {
-    nx_task_add: "deny",
-  },
-  system: `## Role
-
-You are the Writer — the communication specialist who transforms technical content into clear, audience-appropriate documents.
-You receive raw material from Postdoc (research synthesis), Strategist (business analysis), or Engineer (implementation details), then shape it into polished output for the intended audience.
-You use nx_artifact_write to save all deliverables.
-
-## Constraints
-
-- NEVER add analysis or conclusions not present in source material
-- NEVER change the meaning of findings to make them more readable
-- NEVER write content without a clear target audience in mind
-- NEVER skip sending output to Reviewer for validation before delivery
-- NEVER present uncertainty as certainty for the sake of cleaner prose
-
-## Guidelines
-
-## Core Principle
-Writing is translation: take what subject-matter experts know and make it legible to the target audience. Your job is not to add analysis — it is to communicate existing analysis clearly. Every document you write should be shaped by who will read it and what they need to do with it.
-
-## Content Pipeline
-You sit at the output end of the knowledge pipeline:
-- **Postdoc/Researcher** → findings and synthesis → Writer transforms for external audiences
-- **Strategist** → business analysis → Writer transforms for stakeholder communication
-- **Engineer** → implementation details → Writer transforms for developer documentation
-- Output → **Reviewer** validates accuracy before delivery
-
-Do not synthesize new conclusions. Do not add analysis beyond what your source material contains. If your source material is incomplete, flag it and ask for what's missing rather than filling gaps with speculation.
-
-## Audience Calibration
-Before writing, identify:
-1. **Who** is the audience? (developers, executives, end users, general public)
-2. **What** do they already know? (adjust technical depth accordingly)
-3. **What** do they need to do with this document? (decide, implement, learn, approve)
-4. **What** format serves them best? (narrative, bullet points, reference doc, presentation)
-
-## Document Types
-- **Technical documentation**: API docs, architecture guides, developer onboarding materials
-- **Reports**: Research summaries, status updates, findings briefs
-- **Presentations**: Slide outlines, executive summaries, pitch materials
-- **User-facing content**: Readme files, help text, release notes
-
-## Writing Standards
-1. Lead with the conclusion, not the setup — readers should know the point by sentence 3
-2. Use concrete language — replace vague terms ("improved", "better", "significant") with specific ones
-3. Match technical depth to the audience — do not over-explain to experts or under-explain to non-experts
-4. Prefer short sentences and active voice
-5. Structure documents so readers can navigate non-linearly (headers, clear sections)
-6. Do not add commentary that wasn't in the source material
-
-## Output Format
-Choose the template that matches the document type. Keep templates lightweight — adapt structure to content, do not force content into structure.
-
-**Technical Documentation**
-- Purpose / scope
-- Prerequisites (audience knowledge, setup required)
-- Main body (concept explanation, reference material, or step-by-step procedure)
-- Examples
-- Related resources
-
-**Report**
-- Executive summary (1–2 sentences: what was found and why it matters)
-- Context and scope
-- Findings (structured by theme or priority)
-- Implications or recommendations (only if present in source material)
-- Appendix / raw data (if applicable)
-
-**Release Notes**
-- Version and date
-- What changed (grouped by: new features, improvements, bug fixes, breaking changes)
-- Migration steps (if breaking changes exist)
-- Known issues (if any)
-
-For other document types (presentations, runbooks, onboarding guides), derive structure from the audience's workflow — what do they need to do, in what order.
-
-## Saving Deliverables
-Always save output using \`nx_artifact_write\` (filename, content). Never use Write or Edit directly for deliverables.
-
-## Structure Gate
-Before sending output to Reviewer or reporting completion, verify:
-- [ ] All sections declared in the chosen template (or chosen structure) are present and non-empty
-- [ ] Formatting is consistent throughout (heading levels, list style, code block language tags)
-- [ ] Every factual claim traces back to a named source in the source material (no unsourced assertions)
-- [ ] No placeholder text or TODOs remain in the document
-
-This is Writer's self-check scope. **Content accuracy — whether facts match the original source — is Reviewer's responsibility, not Writer's.**
-
-## Completion Report
-After completing a document, report to Lead with the following fields:
-- **File**: artifact filename written via \`nx_artifact_write\`
-- **Audience**: who the document is for and what they will do with it
-- **Sources**: which agents or documents provided the source material
-- **Gaps**: any information that was missing from source material and was flagged (not filled)
-
-## Evidence Requirement
-All claims about impossibility, infeasibility, or platform limitations MUST include evidence: documentation URLs, code paths, error messages, or issue numbers. Unsupported claims trigger re-investigation.
-
-## Escalation Protocol
-Escalate to Lead (and cc the source agent) before writing when:
-- Source material is insufficient to cover a required section without speculation
-- Source material contains internal contradictions that cannot be resolved by context
-- The requested document type or audience is undefined and cannot be inferred from the task
-
-When escalating:
-1. State specifically what information is missing or contradictory
-2. List the sections that cannot be completed without it
-3. Wait for clarification — do not proceed with invented content
-
-Do not escalate for minor phrasing ambiguity or formatting choices — those are Writer's judgment calls.
-`,
-};

package/dist/opencode/src/index.ts

@@ -1,25 +0,0 @@
-// Auto-generated by build-agents.ts — do not edit
-
-import { architect } from "./agents/architect.js";
-import { designer } from "./agents/designer.js";
-import { engineer } from "./agents/engineer.js";
-import { lead } from "./agents/lead.js";
-import { postdoc } from "./agents/postdoc.js";
-import { researcher } from "./agents/researcher.js";
-import { reviewer } from "./agents/reviewer.js";
-import { strategist } from "./agents/strategist.js";
-import { tester } from "./agents/tester.js";
-import { writer } from "./agents/writer.js";
-
-export const agents = [
-  architect,
-  designer,
-  engineer,
-  lead,
-  postdoc,
-  researcher,
-  reviewer,
-  strategist,
-  tester,
-  writer,
-];

package/dist/opencode/src/plugin.ts

@@ -1,6 +0,0 @@
-import type { Plugin } from "@opencode-ai/plugin";
-import { mountHooks } from "@moreih29/nexus-core/hooks/opencode-mount";
-import manifest from "@moreih29/nexus-core/hooks/opencode-manifest" with { type: "json" };
-
-export const OpencodeNexus: Plugin = async (ctx) => mountHooks(ctx, manifest);
-export default OpencodeNexus;

package/dist/scripts/build-agents.d.ts

@@ -1,170 +0,0 @@
-/**
- * scripts/build-agents.ts
- *
- * Build pipeline for nexus agents and skills.
- *
- * Inputs:
- *   assets/agents/<n>/body.md  × 9 agents
- *   assets/skills/<n>/body.md  × 4 skills
- *   assets/capability-matrix.yml
- *   assets/tools/tool-name-map.yml (invocations section)
- *
- * Outputs per harness:
- *   dist/claude/
- *     .claude-plugin/plugin.json       (Template — skip if exists, --force to overwrite)
- *     .claude-plugin/marketplace.json  (Template — skip if exists, --force to overwrite)
- *     agents/<n>.md × N
- *     skills/<n>/SKILL.md × 4
- *     settings.json                    (Managed — primary agent injection, omitted if no primary)
- *
- *   dist/opencode/
- *     package.json                     (Template — skip if exists)
- *     src/index.ts                     (Managed — always overwrite)
- *     src/agents/<n>.ts × N           (Managed — always overwrite, mode:primary gets mode field)
- *     .opencode/skills/<n>/SKILL.md × 4  (Managed)
- *
- *   dist/codex/
- *     plugin/.codex-plugin/plugin.json (Managed)
- *     plugin/skills/<n>/SKILL.md × 4  (Managed)
- *     agents/<n>.toml × N             (Managed)
- *     prompts/<n>.md × N              (Managed)
- *     install/config.fragment.toml    (Managed)
- *     install/AGENTS.fragment.md      (Managed — primary agents only, omitted if none)
- *
- * Overwrite policy:
- *   Managed paths — always overwrite (unless --dry-run)
- *   Template paths — skip if file exists (overwrite only with --force)
- *
- * CLI flags:
- *   --harness=claude|opencode|codex   (default: all)
- *   --target=<dir>                    (default: dist/)
- *   --dry-run                         print affected files, no writes
- *   --force                           force Template file overwrite
- *   --strict                          error if Managed output has untracked modifications
- *   --only=<agent|skill name>         restrict to a single asset
- */
-import type { InvocationsMap, Harness } from "../src/shared/invocations.js";
-export declare const ROOT: string;
-export declare const AGENTS_DIR: string;
-export declare const SKILLS_DIR: string;
-export declare const CAPABILITY_MATRIX_PATH: string;
-export declare const TOOL_NAME_MAP_PATH: string;
-export interface AgentFrontmatter {
-    name: string;
-    description: string;
-    task?: string;
-    alias_ko?: string;
-    category: "how" | "do" | "check" | "lead";
-    mode?: "primary" | "subagent" | "all";
-    resume_tier?: "persistent" | "bounded" | "ephemeral";
-    model_tier: "high" | "standard" | "low";
-    capabilities: string[];
-    id: string;
-    summary?: string;
-    triggers?: string[];
-    manual_only?: boolean;
-    harness_docs_refs?: string[];
-}
-export interface AssetEntry {
-    type: "agent" | "skill";
-    name: string;
-    frontmatter: AgentFrontmatter;
-    body: string;
-    bodyPath: string;
-}
-export interface CapabilityMatrixEntry {
-    claude?: {
-        disallowedTools?: string[];
-    };
-    opencode?: {
-        permission?: Record<string, string>;
-    };
-    codex?: {
-        sandbox_mode?: string | null;
-        disabled_tools?: string[];
-    };
-}
-export interface CapabilityMatrix {
-    capabilities: Record<string, CapabilityMatrixEntry>;
-    model_tier: Record<string, {
-        claude: string;
-        codex: string;
-        opencode: string | null;
-    }>;
-}
-export interface ToolNameMapInvocations {
-    invocations: InvocationsMap;
-}
-export interface BuildOptions {
-    harnesses: Harness[];
-    targetDir: string;
-    dryRun: boolean;
-    force: boolean;
-    strict: boolean;
-    only?: string;
-}
-export type DryRunKind = "managed" | "template";
-export type DryRunReason = "managed" | "template-create" | "template-skipped" | "template-force-overwrite";
-export interface DryRunRecord {
-    path: string;
-    kind: DryRunKind;
-    willWrite: boolean;
-    reason: DryRunReason;
-}
-/**
- * Split a body.md file into frontmatter object and body text.
- * Throws on YAML parse failure.
- */
-export declare function parseFrontmatter(raw: string, filePath: string): {
-    fm: AgentFrontmatter;
-    body: string;
-};
-/**
- * Load all agents and skills from assets/, whitelisting only body.md.
- */
-export declare function loadAssets(opts?: {
-    only?: string;
-}): AssetEntry[];
-export declare function loadCapabilityMatrix(): CapabilityMatrix;
-export declare function loadInvocations(): InvocationsMap;
-/**
- * Collect all Claude disallowedTools for an agent based on its capabilities[].
- */
-export declare function resolveClaudeDisallowedTools(capabilities: string[], capMatrix: CapabilityMatrix): string[];
-/**
- * Collect merged OpenCode permission block for an agent.
- */
-export declare function resolveOpencodePermissions(capabilities: string[], capMatrix: CapabilityMatrix): Record<string, string>;
-/**
- * Resolve codex sandbox_mode and disabled_tools for an agent.
- * sandbox_mode: take the most restrictive non-null value ("read-only" wins).
- */
-export declare function resolveCodexConfig(capabilities: string[], capMatrix: CapabilityMatrix): {
-    sandbox_mode: string | null;
-    disabled_tools: string[];
-};
-/**
- * Resolve model slug for a given model_tier and harness.
- */
-export declare function resolveModel(modelTier: string, harness: Harness, capMatrix: CapabilityMatrix): string | null;
-/**
- * Validate a resolved model value for the claude harness.
- * Allowed: alias (opus|sonnet|haiku), dated ID (claude-opus-4-7 etc.), or null/undefined.
- * Throws on any other value.
- */
-export declare function validateClaudeModel(model: string | null, role: string): void;
-/**
- * Write a file according to the managed/template overwrite policy.
- *
- * Managed: always overwrite (unless --dry-run)
- * Template: skip if exists (overwrite only with --force)
- * --dry-run: record path and intent, no write
- * --strict: error if Managed path has untracked git modifications
- */
-export declare function applyOverwritePolicy(filePath: string, content: string, isManaged: boolean, opts: BuildOptions): DryRunRecord;
-export declare function buildForClaude(assets: AssetEntry[], capMatrix: CapabilityMatrix, invocations: InvocationsMap, opts: BuildOptions): void;
-export declare function buildForOpencode(assets: AssetEntry[], capMatrix: CapabilityMatrix, invocations: InvocationsMap, opts: BuildOptions): void;
-export declare function buildForCodex(assets: AssetEntry[], capMatrix: CapabilityMatrix, invocations: InvocationsMap, opts: BuildOptions): void;
-export declare function parseArgs(argv: string[]): BuildOptions;
-export declare function buildAgents(opts: BuildOptions): Promise<void>;
-//# sourceMappingURL=build-agents.d.ts.map

package/dist/scripts/build-agents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-agents.d.ts","sourceRoot":"","sources":["../../scripts/build-agents.ts"],"names":[],"mappings":"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"}