@nexusclawhq/cli 0.2.4 → 0.3.0

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/README.md.tpl

@@ -0,0 +1,41 @@
+# {{NAME}}
+
+Generic executable-workforce authoring starter generated by the released NexusClaw CLI.
+It contains no industry content, workspace identity, credential, endpoint, provider key,
+record data, or approval-policy guess.
+
+## Bootstrap
+
+```bash
+nexus init {{NAME}}
+npm run dx:pull
+npm run dx:diff
+npm run dx:validate
+npm run dx:pack
+npm run dx:publish
+npm run dx:install
+```
+
+## Generated executable sources
+
+- `packages/generic-action/` was generated by `nexus employee code scaffold`.
+- `packages/generic-flow/GenericFollowUp.flow.yaml` was generated by
+  `nexus employee flow scaffold`.
+- `.nexusclaw/context/` was generated by
+  `nexus ai context export --surface all --offline`; it is authoring-only and
+  cannot authorize stage, candidate test, gate, or promote.
+- `scripts/init-bundle.mjs` invokes `nexus employee bundle init` only after an
+  authenticated context supplies exact `tool_call` and `workforce_release`
+  policy API names. The template never infers them.
+
+Before remote dry-run, export an authenticated `all` context, install its managed
+instruction block for `codex`, `claude`, or `glm-5.2`, initialize the bundle with
+catalog-selected policies, then run `nexus employee bundle deploy --dry-run`.
+
+## Template package refs
+
+- `core.baseline@0.1.0`
+- `code-extension.reference@1.0.0` (`sha256:32959bcec5be439e1adaa48be4fdbbd43715455d6a98a1dc12755d33ca388adf`)
+
+The package digest is an immutable release input; this template does not resolve
+`latest`.

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/nexus-project.json.tpl

@@ -0,0 +1,86 @@
+{
+  "schemaVersion": "nexus-project/v2",
+  "projectName": "{{NAME}}",
+  "apiVersion": "1.0",
+  "sourceRoots": [
+    {
+      "path": "nexus-app/main/default",
+      "kind": "metadata-runtime",
+      "writeTarget": true,
+      "metadataKinds": [
+        "applications",
+        "tabs",
+        "objects",
+        "layouts",
+        "pages",
+        "nwc",
+        "classes",
+        "triggers",
+        "flows",
+        "permissionsets",
+        "profiles",
+        "permissionSetGroups",
+        "roles",
+        "groups",
+        "queues",
+        "labels",
+        "customMetadata",
+        "customSettings",
+        "staticresources",
+        "namedCredentials",
+        "remoteSiteSettings",
+        "notificationTemplates",
+        "isolated"
+      ]
+    },
+    {
+      "path": "nexus-app/main/default/classes",
+      "kind": "code-extension"
+    },
+    {
+      "path": "nexus-app/main/default/triggers",
+      "kind": "code-extension"
+    },
+    {
+      "path": "nexus-app/main/default/nwc",
+      "kind": "code-extension"
+    },
+    {
+      "path": "nexus-app/main/default/isolated",
+      "kind": "code-extension"
+    }
+  ],
+  "localPackages": [
+    {
+      "name": "starter.generic-action",
+      "path": "packages/generic-action",
+      "packageClass": "code-extension"
+    }
+  ],
+  "registry": {
+    "url": "https://packages.nexusclaw.local",
+    "channel": "stable",
+    "rootDirectory": "packages"
+  },
+  "compatibleCoreVersion": "{{CORE_VERSION}}",
+  "defaultOrg": "",
+  "defaultEnvironment": "dev",
+  "environments": [
+    {
+      "name": "dev",
+      "path": "env/dev.sandbox.yaml"
+    }
+  ],
+  "starterTemplate": "executable-workforce",
+  "packageRefs": [
+    "core.baseline@0.1.0",
+    "code-extension.reference@1.0.0"
+  ],
+  "packageDirectories": [
+    {
+      "path": "nexus-app",
+      "default": true
+    }
+  ],
+  "sourceRoot": "nexus-app/main/default"
+}

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/nexus-project.yaml.tpl

@@ -0,0 +1,61 @@
+schemaVersion: "nexus-project/v2"
+projectName: "{{NAME}}"
+apiVersion: "1.0"
+sourceRoots:
+  - path: "nexus-app/main/default"
+    kind: "metadata-runtime"
+    writeTarget: true
+    metadataKinds:
+      - "applications"
+      - "tabs"
+      - "objects"
+      - "layouts"
+      - "pages"
+      - "nwc"
+      - "classes"
+      - "triggers"
+      - "flows"
+      - "permissionsets"
+      - "profiles"
+      - "permissionSetGroups"
+      - "roles"
+      - "groups"
+      - "queues"
+      - "labels"
+      - "customMetadata"
+      - "customSettings"
+      - "staticresources"
+      - "namedCredentials"
+      - "remoteSiteSettings"
+      - "notificationTemplates"
+      - "isolated"
+  - path: "nexus-app/main/default/classes"
+    kind: "code-extension"
+  - path: "nexus-app/main/default/triggers"
+    kind: "code-extension"
+  - path: "nexus-app/main/default/nwc"
+    kind: "code-extension"
+  - path: "nexus-app/main/default/isolated"
+    kind: "code-extension"
+localPackages:
+  - name: "starter.generic-action"
+    path: "packages/generic-action"
+    packageClass: "code-extension"
+registry:
+  url: "https://packages.nexusclaw.local"
+  channel: "stable"
+  rootDirectory: "packages"
+compatibleCoreVersion: "{{CORE_VERSION}}"
+defaultOrg: ""
+defaultEnvironment: "dev"
+environments:
+  - name: "dev"
+    path: "env/dev.sandbox.yaml"
+starterTemplate: "executable-workforce"
+packageRefs:
+  - "core.baseline@0.1.0"
+  - "code-extension.reference@1.0.0"
+packageDirectories:
+  - path: "nexus-app"
+    default: true
+sourceRoot: "nexus-app/main/default"

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/package.json.tpl

@@ -0,0 +1,25 @@
+{
+  "name": "{{NAME}}",
+  "private": true,
+  "version": "0.1.0",
+  "description": "Generic governed executable workforce starter",
+  "scripts": {
+    "build": "tsc",
+    "dx:pull": "./scripts/pull.sh",
+    "dx:diff": "./scripts/diff-runtime.sh",
+    "dx:diff:source": "./scripts/diff-source.sh",
+    "dx:diff:composer": "./scripts/diff-composer.sh",
+    "dx:validate": "./scripts/validate.sh",
+    "dx:pack": "./scripts/pack.sh",
+    "dx:publish": "./scripts/publish.sh",
+    "dx:install": "./scripts/install.sh",
+    "dx:rollback": "./scripts/rollback.sh",
+    "workforce:bundle:init": "node ./scripts/init-bundle.mjs"
+  },
+  "dependencies": {
+    "@nexusclaw/runtime": "latest"
+  },
+  "devDependencies": {
+    "typescript": "^5.1.0"
+  }
+}

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/packages/generic-action/.nexusclaw/scaffold.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": "nexusclaw.code-scaffold-marker/v1",
+  "generator": "nexus-cli/employee.code.scaffold#scaffold@v1",
+  "files": {
+    "package.yaml": "sha256:531053fb3fc8ff0bf418a1708eb9e05b605d46cab71e1d33299bd6a3359f9546",
+    "agent-tools.json": "sha256:395630551c90df42c9a1357d5b2933a410168719354d6d4b51ecc2f62518e5c9",
+    "code/genericLookup.ts": "sha256:6d4a17829892218e2a375dc643306769fe937ecdcd8717c0838ddf1c2b3f29c6",
+    "schemas/genericLookup.input.schema.json": "sha256:91e1556fb053be7728bab4ce7b2823ca64807c5ffa117a3e8fbba79c683a2344",
+    "schemas/genericLookup.output.schema.json": "sha256:91e1556fb053be7728bab4ce7b2823ca64807c5ffa117a3e8fbba79c683a2344",
+    "tests/genericLookup.cases.json": "sha256:c319255346765efce79c61330efbefdb01c8331e1e8584b53a7bd50bc03914ab"
+  }
+}

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/packages/generic-action/agent-tools.json

@@ -0,0 +1,53 @@
+{
+  "schemaVersion": "agent-code-tool-catalog/v1",
+  "packageName": "starter.generic-action",
+  "packageVersion": "0.1.0",
+  "exports": [
+    {
+      "contractVersion": "agent-code-tool/v1",
+      "actionContractVersion": "nexus-code-action/v1",
+      "exportId": "genericLookup",
+      "artifactRef": "genericLookup",
+      "toolName": "custom.starter.generic_lookup",
+      "description": "Governed code action genericLookup.",
+      "inputSchemaRef": "schemas/genericLookup.input.schema.json",
+      "outputSchemaRef": "schemas/genericLookup.output.schema.json",
+      "sideEffectMode": "read_only",
+      "declaredRiskLevel": "L0",
+      "capabilities": {
+        "records": [],
+        "connectors": [],
+        "ai": []
+      },
+      "limits": {
+        "timeoutMs": 60000,
+        "memoryMb": 128,
+        "maxQueries": 10,
+        "maxDmlStatements": 10,
+        "maxDmlRows": 50,
+        "maxCallouts": 2,
+        "maxAiCalls": 1,
+        "maxAiInputTokens": 8000,
+        "maxAiOutputTokens": 2000,
+        "maxAiCost": {
+          "amount": "0",
+          "currency": "USD"
+        },
+        "maxLogEntries": 50,
+        "maxLogBytes": 32768,
+        "maxAttempts": 1
+      },
+      "redaction": {
+        "inputJsonPointers": [],
+        "outputJsonPointers": [],
+        "logPolicy": "metadata_only"
+      },
+      "tests": [
+        {
+          "path": "tests/genericLookup.cases.json",
+          "required": true
+        }
+      ]
+    }
+  ]
+}

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/packages/generic-action/code/genericLookup.ts

@@ -0,0 +1,5 @@
+import type { CodeAction, ActionInput, ActionOutput } from '@nexusclaw/code-sdk/agent-action-v1';
+
+const action: CodeAction<ActionInput, ActionOutput> = async (_ctx, input) => ({ ...input });
+
+export default action;

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/packages/generic-action/package.yaml

@@ -0,0 +1,28 @@
+agentToolCatalogPath: agent-tools.json
+codeExtensionGovernance:
+  contractVersion: code-extension-governance/v2
+  runtimeApiVersion: runtime/v2
+compatibleCoreVersion: '>=0.1.0'
+dependencies: []
+description: Governed code action package for genericLookup.
+executableArtifacts:
+  - actionContractVersion: nexus-code-action/v1
+    apiName: genericLookup
+    entrypoint: default
+    extensionId: genericLookup
+    functionType: ACTION
+    kind: function
+    runtimeApiVersion: runtime/v2
+    sourcePath: code/genericLookup.ts
+includedCodeKinds:
+  - function
+includedMetadataKinds: []
+includedSeedKinds: []
+installOrder: 100
+name: starter.generic-action
+packageClass: code-extension
+packageType: code-extension
+releaseChannel: preview
+schemaVersion: v1
+version: 0.1.0
+visibility: internal

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/packages/generic-action/schemas/genericLookup.input.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {}
+}

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/packages/generic-action/schemas/genericLookup.output.schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {}
+}

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/packages/generic-action/tests/genericLookup.cases.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": "code-action-cases/v1",
+  "actionExportId": "genericLookup",
+  "principalFixtures": [
+    {
+      "fixtureId": "bound",
+      "base": "bound_candidate_agent"
+    }
+  ],
+  "cases": [
+    {
+      "caseId": "minimal",
+      "input": {},
+      "principalFixtureId": "bound",
+      "clock": "2026-01-01T00:00:00.000Z",
+      "hostFixtures": {
+        "calls": []
+      },
+      "expect": {
+        "outcome": "success",
+        "output": {},
+        "mutations": []
+      }
+    }
+  ]
+}

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/packages/generic-flow/GenericFollowUp.flow.yaml

@@ -0,0 +1,10 @@
+data:
+  - actions: []
+    apiName: GenericFollowUp
+    form: rule
+    name: GenericFollowUp
+    trigger:
+      type: MANUAL
+kind: flows
+moduleId: starter.generic-flow
+schemaVersion: payload/v2

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/scripts/init-bundle.mjs

@@ -0,0 +1,25 @@
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+
+const [contextManifest, workforcePolicy, toolPolicy] = process.argv.slice(2);
+if (!contextManifest || !workforcePolicy || !toolPolicy) {
+  console.error(
+    'Usage: npm run workforce:bundle:init -- <context-manifest> <workforce-release-policy-api-name> <tool-call-policy-api-name>',
+  );
+  process.exit(2);
+}
+
+const result = spawnSync(
+  'nexus',
+  [
+    'employee', 'bundle', 'init', 'StarterWorkforce',
+    '--workspace', process.cwd(),
+    '--out', path.join(process.cwd(), 'bundle'),
+    '--context', path.resolve(contextManifest),
+    '--workforce-approval-policy', workforcePolicy,
+    '--tool-approval-policy', toolPolicy,
+    '--json',
+  ],
+  { stdio: 'inherit', env: process.env },
+);
+process.exit(result.status ?? 1);

package/dist/nexus-cli/src/templates/project/templates/executable-workforce/tsconfig.json.tpl

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noEmit": true
+  },
+  "include": ["packages/**/*.ts"]
+}

package/dist/nexus-cli/src/templates/project/templates/industry-education/README.md.tpl

@@ -24,9 +24,15 @@ The starter package workflow defaults to `packages/org-base`. Pass `-- --source
 to `dx:pack`, `dx:publish`, `dx:install`, and `dx:rollback` when operating on a different local
 package.
 
+## Template package refs
+
+- `core.baseline@0.1.0` (required environment baseline)
+- `overlay.generic-crm@0.1.0`
+- `industry.education@0.1.0`
+
 ## Custom Pages (source DX)
 
-Pages live in `src/metadata/pages/` as pairs of:
+Pages live in `nexus-app/main/default/pages/` as pairs of:
 
 - `<apiName>.page.json` — page metadata
 - `<apiName>.page.schema.json` — page schema blob

package/dist/nexus-cli/src/templates/project/templates/industry-education/nexus-project.json.tpl

@@ -1,18 +1,66 @@
 {
-  "schemaVersion": "dx-workspace/v1",
+  "schemaVersion": "nexus-project/v2",
   "projectName": "{{NAME}}",
   "apiVersion": "1.0",
   "sourceRoots": [
-    { "path": "src/metadata", "kind": "metadata-runtime", "writeTarget": true },
-    { "path": "src/classes", "kind": "code-extension" },
-    { "path": "src/triggers", "kind": "code-extension" },
-    { "path": "src/components", "kind": "code-extension" },
-    { "path": "src/tests", "kind": "code-extension" },
-    { "path": "src/metadata/pages", "kind": "metadata-runtime", "metadataKinds": ["pages"], "sourceOfTruthMode": "require-explicit", "orphanPolicy": "prompt" }
+    {
+      "path": "nexus-app/main/default",
+      "kind": "metadata-runtime",
+      "writeTarget": true,
+      "metadataKinds": [
+        "applications",
+        "tabs",
+        "objects",
+        "layouts",
+        "pages",
+        "nwc",
+        "classes",
+        "triggers",
+        "flows",
+        "permissionsets",
+        "profiles",
+        "permissionSetGroups",
+        "roles",
+        "groups",
+        "queues",
+        "labels",
+        "customMetadata",
+        "customSettings",
+        "staticresources",
+        "namedCredentials",
+        "remoteSiteSettings",
+        "notificationTemplates",
+        "isolated"
+      ]
+    },
+    {
+      "path": "nexus-app/main/default/classes",
+      "kind": "code-extension"
+    },
+    {
+      "path": "nexus-app/main/default/triggers",
+      "kind": "code-extension"
+    },
+    {
+      "path": "nexus-app/main/default/nwc",
+      "kind": "code-extension"
+    },
+    {
+      "path": "nexus-app/main/default/isolated",
+      "kind": "code-extension"
+    }
   ],
   "localPackages": [
-    { "name": "workspace.org-base", "path": "packages/org-base", "packageClass": "metadata" },
-    { "name": "workspace.sales-extension", "path": "packages/sales-extension", "packageClass": "metadata" }
+    {
+      "name": "workspace.org-base",
+      "path": "packages/org-base",
+      "packageClass": "metadata"
+    },
+    {
+      "name": "workspace.sales-extension",
+      "path": "packages/sales-extension",
+      "packageClass": "metadata"
+    }
   ],
   "registry": {
     "url": "https://packages.nexusclaw.local",
@@ -23,15 +71,30 @@
   "defaultOrg": "",
   "defaultEnvironment": "dev",
   "environments": [
-    { "name": "dev", "path": "env/dev.sandbox.yaml" },
-    { "name": "uat", "path": "env/uat.sandbox.yaml" },
-    { "name": "prod", "path": "env/prod.install.yaml" }
+    {
+      "name": "dev",
+      "path": "env/dev.sandbox.yaml"
+    },
+    {
+      "name": "uat",
+      "path": "env/uat.sandbox.yaml"
+    },
+    {
+      "name": "prod",
+      "path": "env/prod.install.yaml"
+    }
   ],
   "starterTemplate": "industry-education",
   "packageRefs": [
     "core.baseline@0.1.0",
     "overlay.generic-crm@0.1.0",
     "industry.education@0.1.0"
-  ]
+  ],
+  "packageDirectories": [
+    {
+      "path": "nexus-app",
+      "default": true
+    }
+  ],
+  "sourceRoot": "nexus-app/main/default"
 }
-

package/dist/nexus-cli/src/templates/project/templates/industry-education/nexus-project.yaml.tpl

@@ -0,0 +1,69 @@
+schemaVersion: "nexus-project/v2"
+projectName: "{{NAME}}"
+apiVersion: "1.0"
+sourceRoots:
+  - path: "nexus-app/main/default"
+    kind: "metadata-runtime"
+    writeTarget: true
+    metadataKinds:
+      - "applications"
+      - "tabs"
+      - "objects"
+      - "layouts"
+      - "pages"
+      - "nwc"
+      - "classes"
+      - "triggers"
+      - "flows"
+      - "permissionsets"
+      - "profiles"
+      - "permissionSetGroups"
+      - "roles"
+      - "groups"
+      - "queues"
+      - "labels"
+      - "customMetadata"
+      - "customSettings"
+      - "staticresources"
+      - "namedCredentials"
+      - "remoteSiteSettings"
+      - "notificationTemplates"
+      - "isolated"
+  - path: "nexus-app/main/default/classes"
+    kind: "code-extension"
+  - path: "nexus-app/main/default/triggers"
+    kind: "code-extension"
+  - path: "nexus-app/main/default/nwc"
+    kind: "code-extension"
+  - path: "nexus-app/main/default/isolated"
+    kind: "code-extension"
+localPackages:
+  - name: "workspace.org-base"
+    path: "packages/org-base"
+    packageClass: "metadata"
+  - name: "workspace.sales-extension"
+    path: "packages/sales-extension"
+    packageClass: "metadata"
+registry:
+  url: "https://packages.nexusclaw.local"
+  channel: "stable"
+  rootDirectory: "packages"
+compatibleCoreVersion: "{{CORE_VERSION}}"
+defaultOrg: ""
+defaultEnvironment: "dev"
+environments:
+  - name: "dev"
+    path: "env/dev.sandbox.yaml"
+  - name: "uat"
+    path: "env/uat.sandbox.yaml"
+  - name: "prod"
+    path: "env/prod.install.yaml"
+starterTemplate: "industry-education"
+packageRefs:
+  - "core.baseline@0.1.0"
+  - "overlay.generic-crm@0.1.0"
+  - "industry.education@0.1.0"
+packageDirectories:
+  - path: "nexus-app"
+    default: true
+sourceRoot: "nexus-app/main/default"

package/dist/nexus-cli/src/templates/project/templates/industry-finance/README.md.tpl

@@ -24,9 +24,15 @@ The starter package workflow defaults to `packages/org-base`. Pass `-- --source
 to `dx:pack`, `dx:publish`, `dx:install`, and `dx:rollback` when operating on a different local
 package.
 
+## Template package refs
+
+- `core.baseline@0.1.0` (required environment baseline)
+- `overlay.generic-crm@0.1.0`
+- `industry.finance@0.1.0`
+
 ## Custom Pages (source DX)
 
-Pages live in `src/metadata/pages/` as pairs of:
+Pages live in `nexus-app/main/default/pages/` as pairs of:
 
 - `<apiName>.page.json` — page metadata
 - `<apiName>.page.schema.json` — page schema blob