Custom Function directory/project scaffolding by bencmbrook · Pull Request #519 · transcend-io/tools

bencmbrook · 2026-09-07T20:54:32Z

Closes LINK-8250: Add interactive Custom Function scaffolding to the CLI

Screen.Recording.2026-09-07.at.8.54.10.PM.mov

Summary

Add a credential-free local workflow for developing Transcend Custom Functions.

transcend custom-functions init creates a project under the explicit default transcend/custom-functions. It can add Deno configuration, editor recommendations, the transcend-custom-functions AI authoring skill, and validation-only GitHub Actions.
transcend custom-functions new adds a typed General or data subject request (DSR) starter, representative test payloads, and the matching manifest entry to an initialized project.
transcend custom-functions run executes configured fixtures in a local Deno 2 simulator and prints function logs. It mirrors Sombra's export selection, payload preparation, environment isolation, timeout, software development kit (SDK), and key-value (KV) shape without requiring credentials. sdk.fetch is simulated, and native network access requires an explicit --allowNetwork opt-in.
transcend custom-functions check validates the manifest, files, payload schemas, exports, types, lint, and formatting with Deno 2 before the project is pushed. Generated configuration pins the production Deno version; other Deno 2 versions produce a compatibility warning.
Manifest placeholders retain the existing <<parameters.*>> syntax and are supplied through the backward-compatible --variables flag. Local runs and checks require explicit values, while generated commands provide non-secret placeholders.

Each scaffold command previews one transactional plan, preserves existing configuration, carries custom manifest paths through follow-up commands, and finishes with a compact AI handoff. Source and test payload paths remain within the manifest directory across run, check, and push, including through symlinks. Customized workflows are left unchanged. In a bare project, repository-level .vscode and .agents setup is placed at the invocation root while Custom Function files remain isolated under the target directory.

The AI guidance is also published as a literal repository skill, so it can be installed before setup with npx skills add transcend-io/tools --skill transcend-custom-functions.

Validation

Targeted Custom Function suite (186 tests)
Isolated CLI example-command suite (308 tests)
Real Deno 2.4.5 end-to-end checks for validation and local execution
Local simulator coverage for payload/export selection, SDK/KV behavior, permissions, timeouts, output safety, and multi-payload failures
Generated workflow YAML parsing and security assertions
CLI typecheck, lint, production build, and export checks
Bundled Agent Skill asset check
Pre-commit quality checks

LINK-8250

linear-code · 2026-09-07T20:54:38Z

LINK-8250

pkg-pr-new · 2026-09-07T20:57:30Z

Open in StackBlitz

@transcend-io/airgap.js-types

pnpm add https://pkg.pr.new/@transcend-io/airgap.js-types@519

yarn add https://pkg.pr.new/@transcend-io/airgap.js-types@519.tgz

@transcend-io/cli

pnpm add https://pkg.pr.new/@transcend-io/cli@519

yarn add https://pkg.pr.new/@transcend-io/cli@519.tgz

@transcend-io/custom-function-types

pnpm add https://pkg.pr.new/@transcend-io/custom-function-types@519

yarn add https://pkg.pr.new/@transcend-io/custom-function-types@519.tgz

@transcend-io/design-tokens

pnpm add https://pkg.pr.new/@transcend-io/design-tokens@519

yarn add https://pkg.pr.new/@transcend-io/design-tokens@519.tgz

@transcend-io/internationalization

pnpm add https://pkg.pr.new/@transcend-io/internationalization@519

yarn add https://pkg.pr.new/@transcend-io/internationalization@519.tgz

@transcend-io/privacy-types

pnpm add https://pkg.pr.new/@transcend-io/privacy-types@519

yarn add https://pkg.pr.new/@transcend-io/privacy-types@519.tgz

@transcend-io/sdk

pnpm add https://pkg.pr.new/@transcend-io/sdk@519

yarn add https://pkg.pr.new/@transcend-io/sdk@519.tgz

@transcend-io/type-utils

pnpm add https://pkg.pr.new/@transcend-io/type-utils@519

yarn add https://pkg.pr.new/@transcend-io/type-utils@519.tgz

@transcend-io/utils

pnpm add https://pkg.pr.new/@transcend-io/utils@519

yarn add https://pkg.pr.new/@transcend-io/utils@519.tgz

@transcend-io/mcp

pnpm add https://pkg.pr.new/@transcend-io/mcp@519

yarn add https://pkg.pr.new/@transcend-io/mcp@519.tgz

@transcend-io/mcp-server-admin

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-admin@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-admin@519.tgz

@transcend-io/mcp-server-assessment

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-assessment@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-assessment@519.tgz

@transcend-io/mcp-server-base

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-base@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-base@519.tgz

@transcend-io/mcp-server-consent

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-consent@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-consent@519.tgz

@transcend-io/mcp-server-discovery

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-discovery@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-discovery@519.tgz

@transcend-io/mcp-server-docs

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-docs@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-docs@519.tgz

@transcend-io/mcp-server-dsr

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-dsr@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-dsr@519.tgz

@transcend-io/mcp-server-inventory

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-inventory@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-inventory@519.tgz

@transcend-io/mcp-server-preferences

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-preferences@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-preferences@519.tgz

@transcend-io/mcp-server-workflows

pnpm add https://pkg.pr.new/@transcend-io/mcp-server-workflows@519

yarn add https://pkg.pr.new/@transcend-io/mcp-server-workflows@519.tgz

commit: 70b224b

giacaglia

Nice!

ecton-transcend

So cool! Thanks for putting this together. The onboard experience is much cleaner now

Keep the established --variables interface while retaining the <<parameters.*>> manifest syntax. Require explicit values in local validation and execution, and surface safe placeholders in generated guidance.

Require source and test payload paths to remain under the manifest directory for push, run, and check. Document the shared contract with the relevant manifest fields.

bencmbrook changed the base branch from main to docs/cli-command-boundaries-rule September 7, 2026 20:55

bencmbrook changed the title ~~benbrook/link 8250 custom function scaffolding~~ Custom Function project scaffolding Sep 7, 2026

bencmbrook changed the title ~~Custom Function project scaffolding~~ Custom Function directory/project scaffolding Sep 7, 2026

bencmbrook requested review from ecton-transcend and michaelfarrell76 September 8, 2026 00:08

bencmbrook marked this pull request as ready for review September 8, 2026 01:10

bencmbrook requested review from a team as code owners September 8, 2026 01:10

giacaglia previously approved these changes Sep 8, 2026

View reviewed changes

bencmbrook force-pushed the benbrook/link-8250-custom-function-scaffolding branch from bd430ee to 5696e13 Compare September 8, 2026 02:22

Base automatically changed from docs/cli-command-boundaries-rule to main September 8, 2026 02:32

bencmbrook force-pushed the benbrook/link-8250-custom-function-scaffolding branch from 5696e13 to ee9dfef Compare September 8, 2026 02:32

bencmbrook dismissed giacaglia’s stale review via 9519f8c September 8, 2026 15:24

dmattia previously approved these changes Sep 8, 2026

View reviewed changes

Comment thread .github/workflows/ci.yml Outdated

ecton-transcend previously approved these changes Sep 8, 2026

View reviewed changes

bencmbrook mentioned this pull request Sep 8, 2026

Scaffold Policy Engine projects #520

Merged

bencmbrook dismissed stale reviews from ecton-transcend and dmattia via 1c70165 September 8, 2026 16:50

bencmbrook added 9 commits September 8, 2026 17:45

fix(custom-functions): allow raw DSR payloads without data silo

361539b

feat(custom-functions): export authoring contract version

e266b57

refactor(custom-functions): separate manifest parsing from hydration

e102b64

feat(custom-functions): add transactional scaffold planner

2137385

feat(custom-functions): add init new and check commands

a3424fe

test(custom-functions): cover local authoring workflows

a01839a

docs(custom-functions): document local authoring workflows

f38956f

chore: add Custom Function scaffolding changeset

05d1de8

fix(custom-functions): follow CLI command conventions

d7dae1a

bencmbrook added 24 commits September 8, 2026 17:45

feat(cli): print AI handoffs after scaffolding

2fd842a

docs(cli): simplify function scaffold release notes

bd3799c

feat(cli): finalize custom function agent skill

ee3903d

feat(cli): publish custom function agent skill

6916ddd

docs(skill): link custom function references

624d9a3

docs(cli): clarify custom function AI handoff

af8634f

fix(cli): harden custom function scaffolding

56d840d

docs(cli): align custom function setup guidance

45e9794

fix(cli): root bare custom function setup

0aaebe5

feat(cli): polish custom function output

ddacaf1

feat(cli): style custom function output

419385c

feat(cli): shorten scaffold instructions

0e8a104

feat(cli): add local custom function simulator

11815d5

feat(cli): expose custom-functions run

ad5fb13

fix(cli): match production Deno 2.4.5

fbc508e

fix(cli): align manifest parameter flags

63d1a85

fix(cli): default local environment parameters

635f851

fix(cli): harden custom function execution

959062d

fix(cli): make scaffolding updates resilient

bec825c

docs(cli): document custom function safeguards

80df2e2

fix(cli): contain local function dependencies

f556764

fix(cli): support all Deno 2 versions

adda855

Restore Custom Function variables

7409803

Keep the established --variables interface while retaining the <<parameters.*>> manifest syntax. Require explicit values in local validation and execution, and surface safe placeholders in generated guidance.

Unify Custom Function path handling

70b224b

Require source and test payload paths to remain under the manifest directory for push, run, and check. Document the shared contract with the relevant manifest fields.

bencmbrook force-pushed the benbrook/link-8250-custom-function-scaffolding branch from cfc8ec1 to 70b224b Compare September 8, 2026 21:45

bencmbrook merged commit 7384caa into main Sep 8, 2026
4 checks passed

bencmbrook deleted the benbrook/link-8250-custom-function-scaffolding branch September 8, 2026 22:00

This was referenced Sep 8, 2026

🤏 Install Deno in Version and Publish workflows #523

Merged

docs(cli): name the Custom Function type each custom-functions new template creates #539

Merged

Changesets cursor rule #544

Merged

Navigation Menu

Repository navigation

Custom Function directory/project scaffolding - #519

Custom Function directory/project scaffolding#519
bencmbrook merged 54 commits into
mainfrom
benbrook/link-8250-custom-function-scaffolding

bencmbrook commented Sep 7, 2026 •

edited

Loading

Uh oh!

linear-code Bot commented Sep 7, 2026

Uh oh!

pkg-pr-new Bot commented Sep 7, 2026 •

edited

Loading

Uh oh!

giacaglia left a comment

Uh oh!

Uh oh!

ecton-transcend left a comment

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

bencmbrook commented Sep 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Validation

Uh oh!

linear-code Bot commented Sep 7, 2026

Uh oh!

pkg-pr-new Bot commented Sep 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

giacaglia left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ecton-transcend left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

bencmbrook commented Sep 7, 2026 •

edited

Loading

pkg-pr-new Bot commented Sep 7, 2026 •

edited

Loading