Skip to content

The open alternative to Salesforce, designed for AI.

fix(ci): track standalone CLI in docs and skills drift checks (#28646)

Weiko11fdc85750f5
diff --git a/.github/workflows/ci-agent-skills-drift.yaml b/.github/workflows/ci-agent-skills-drift.yaml
index 7bcedfa3b6b..271c31f191d 100644
--- a/.github/workflows/ci-agent-skills-drift.yaml
+++ b/.github/workflows/ci-agent-skills-drift.yaml
@@ -1,8 +1,8 @@
name: CI Agent Skills Drift
-# When a PR changes the app-development surface (twenty-sdk, create-twenty-app,
-# twenty-client-sdk, or the shared manifest types), an agent checks whether the
-# canonical skill content under packages/twenty-agent-skills is impacted and,
+# When a PR changes the app-development surface (twenty-cli, twenty-sdk,
+# create-twenty-app, twenty-client-sdk, or shared manifest types), an agent checks
+# whether the canonical skill content under packages/twenty-agent-skills is impacted and,
# only when it is, posts a single sticky comment with its findings.
#
# This is the skills counterpart to ci-app-docs-drift.yaml: the same source
@@ -24,6 +24,7 @@ jobs:
uses: ./.github/workflows/changed-files.yaml
with:
files: |
+ packages/twenty-cli/**
packages/twenty-sdk/**
packages/create-twenty-app/**
packages/twenty-client-sdk/**
@@ -82,18 +83,21 @@ jobs:
see fit. Only these kinds of changes are skill-relevant:
- CLI commands, subcommands, flags, defaults, or help text
- (`packages/twenty-sdk/src/cli/commands/**`)
+ (`packages/twenty-cli/src/commands/**`, `packages/twenty-sdk/src/cli/commands/**`)
- `define*` function signatures, config properties, validation rules,
or their warnings (`packages/twenty-sdk/src/sdk/define/**`)
- Enum / string-union values and manifest types
(`packages/twenty-shared/src/application/**`, `packages/twenty-shared/src/types/**`)
- - Exports added/removed/renamed in the `exports` maps of `twenty-sdk` or
+ - Exports added/removed/renamed in the `exports` maps of `twenty`, `twenty-sdk`, or
`twenty-client-sdk` package.json, or in their public entry points
- Front-component runtime hooks and host API
(`packages/twenty-sdk/src/sdk/front-component/**`)
- - The scaffold template (`packages/create-twenty-app/src/constants/template/**`)
- and scaffolder flags/prompts (`packages/create-twenty-app/src/cli.ts`,
- `create-app.command.ts`)
+ - Scaffold templates (`packages/twenty-cli/app-template/**`,
+ `packages/create-twenty-app/src/constants/template/**`)
+ and scaffolder flags/prompts (`packages/twenty-cli/src/commands/app/init/**`,
+ `packages/twenty-cli/src/app/create-app-project.ts`,
+ `packages/create-twenty-app/src/cli.ts`,
+ `packages/create-twenty-app/src/create-app.command.ts`)
- Environment variables injected into logic functions or front components
- Error codes surfaced to app developers
- Default ports and instance URLs used during development
@@ -108,7 +112,7 @@ jobs:
| Source area | Skill content |
|---|---|
- | CLI commands (`src/cli/commands`) | `references/manage-app/cli-and-sync.md`, `skills/manage-app/SKILL.md`, `references/concepts/operating-rules.md` |
+ | CLI commands (`twenty-cli/src/commands`, `twenty-sdk/src/cli/commands`) | `references/manage-app/cli-and-sync.md`, `skills/manage-app/SKILL.md`, `references/concepts/operating-rules.md` |
| Scaffolder flags, prompts, template | `skills/create-app/SKILL.md`, `references/develop-app/app-structure.md` |
| `defineObject`/`defineField`/relations/indexes | `references/develop-app/data-model.md` |
| `defineApplication`/roles/install hooks/variables | `references/concepts/how-apps-work.md`, `references/publish-app/prepare-for-app-store.md` |
diff --git a/.github/workflows/ci-app-docs-drift.yaml b/.github/workflows/ci-app-docs-drift.yaml
index abb0cba1286..74fd306ceb5 100644
--- a/.github/workflows/ci-app-docs-drift.yaml
+++ b/.github/workflows/ci-app-docs-drift.yaml
@@ -1,8 +1,8 @@
name: CI App Docs Drift
-# When a PR changes the app-development surface (twenty-sdk, create-twenty-app,
-# twenty-client-sdk, or the shared manifest types), an agent checks whether the
-# app documentation under packages/twenty-docs/developers/extend/apps is
+# When a PR changes the app-development surface (twenty-cli, twenty-sdk,
+# create-twenty-app, twenty-client-sdk, or shared manifest types), an agent checks
+# whether the app documentation under packages/twenty-docs/developers/extend/apps is
# impacted and, only when it is, posts a single sticky comment with its findings.
on:
@@ -21,6 +21,7 @@ jobs:
uses: ./.github/workflows/changed-files.yaml
with:
files: |
+ packages/twenty-cli/**
packages/twenty-sdk/**
packages/create-twenty-app/**
packages/twenty-client-sdk/**
@@ -70,18 +71,21 @@ jobs:
see fit. Only these kinds of changes are documentation-relevant:
- CLI commands, subcommands, flags, defaults, or help text
- (`packages/twenty-sdk/src/cli/commands/**`)
+ (`packages/twenty-cli/src/commands/**`, `packages/twenty-sdk/src/cli/commands/**`)
- `define*` function signatures, config properties, validation rules,
or their warnings (`packages/twenty-sdk/src/sdk/define/**`)
- Enum / string-union values and manifest types
(`packages/twenty-shared/src/application/**`, `packages/twenty-shared/src/types/**`)
- - Exports added/removed/renamed in the `exports` maps of `twenty-sdk` or
+ - Exports added/removed/renamed in the `exports` maps of `twenty`, `twenty-sdk`, or
`twenty-client-sdk` package.json, or in their public entry points
- Front-component runtime hooks and host API
(`packages/twenty-sdk/src/sdk/front-component/**`)
- - The scaffold template (`packages/create-twenty-app/src/constants/template/**`)
- and scaffolder flags/prompts (`packages/create-twenty-app/src/cli.ts`,
- `create-app.command.ts`)
+ - Scaffold templates (`packages/twenty-cli/app-template/**`,
+ `packages/create-twenty-app/src/constants/template/**`)
+ and scaffolder flags/prompts (`packages/twenty-cli/src/commands/app/init/**`,
+ `packages/twenty-cli/src/app/create-app-project.ts`,
+ `packages/create-twenty-app/src/cli.ts`,
+ `packages/create-twenty-app/src/create-app.command.ts`)
- Environment variables injected into logic functions or front components
- Error codes surfaced to app developers
@@ -94,7 +98,7 @@ jobs:
| Source area | Docs pages |
|---|---|
- | CLI commands (`src/cli/commands`) | `operations/cli.mdx`, `getting-started/quick-start.mdx`, `operations/sync-and-recovery.mdx`, `getting-started/local-server.mdx`, `getting-started/scaffolding.mdx` |
+ | CLI commands (`twenty-cli/src/commands`, `twenty-sdk/src/cli/commands`) | `operations/cli.mdx`, `getting-started/quick-start.mdx`, `operations/sync-and-recovery.mdx`, `getting-started/local-server.mdx`, `getting-started/scaffolding.mdx` |
| `defineObject`/`defineField`/relations/indexes | `data/*.mdx` |
| `defineApplication`/roles/install hooks/variables | `config/*.mdx` |
| Logic functions, triggers, connections, agents/skills | `logic/*.mdx` |