Skip to content

Commit dddebd5

Browse files
committed
added asset progress manager ui update
2 parents 8981552 + 1ab13eb commit dddebd5

194 files changed

Lines changed: 13505 additions & 26766 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.cursor/rules/README.md

Lines changed: 3 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -1,107 +1,5 @@
1-
# Cursor Rules
1+
# Cursor (optional)
22

3-
Context-aware rules that load automatically based on the files you're editing, optimized for this Contentstack CLI plugins monorepo.
3+
**Cursor** users: start at **[AGENTS.md](../../AGENTS.md)**. All conventions live in **`skills/*/SKILL.md`**.
44

5-
## Rule Files
6-
7-
| File | Scope | Always Applied | Purpose |
8-
|------|-------|----------------|---------|
9-
| `dev-workflow.md` | `**/*.ts`, `**/*.js`, `**/*.json` | Yes | Monorepo TDD workflow, pnpm workspace patterns |
10-
| `typescript.mdc` | `**/*.ts`, `**/*.tsx` | No | TypeScript config variations, naming conventions |
11-
| `testing.mdc` | `**/test/**/*.ts`, `**/test/**/*.js`, `**/*.test.ts`, `**/*.spec.ts` | Yes | Mocha, Chai, Sinon patterns, nyc coverage |
12-
| `oclif-commands.mdc` | `**/commands/**/*.ts` | No | OCLIF patterns, BaseCommand classes, CLI validation |
13-
| `contentstack-cli.mdc` | `**/import/**/*.ts`, `**/export/**/*.ts`, `**/modules/**/*.ts`, `**/services/**/*.ts`, `**/utils/**/*.ts` | No | API integration, rate limiting, batch processing |
14-
15-
## Commands
16-
17-
| File | Trigger | Purpose |
18-
|------|---------|---------|
19-
| `execute-tests.md` | `/execute-tests` | Run tests by scope, package, or module with monorepo awareness |
20-
| `code-review.md` | `/code-review` | Automated PR review with Contentstack CLI specific checklist |
21-
22-
## Loading Behaviour
23-
24-
### File Type Mapping
25-
- **TypeScript files**`typescript.mdc` + `dev-workflow.md`
26-
- **Command files** (`packages/*/src/commands/**/*.ts`) → `oclif-commands.mdc` + `typescript.mdc` + `dev-workflow.md`
27-
- **Import/Export modules** (`packages/*/src/{import,export,modules}/**/*.ts`) → `contentstack-cli.mdc` + `typescript.mdc` + `dev-workflow.md`
28-
- **Service files** (`packages/*/src/services/**/*.ts`) → `contentstack-cli.mdc` + `typescript.mdc` + `dev-workflow.md`
29-
- **Test files** (`packages/*/test/**/*.{ts,js}`) → `testing.mdc` + relevant domain rules + `dev-workflow.md`
30-
- **Utility files** (`packages/*/src/utils/**/*.ts`) → `contentstack-cli.mdc` + `typescript.mdc` + `dev-workflow.md`
31-
32-
### Package-Specific Loading
33-
- **Plugin packages** (with `oclif.commands`) → Full command and API rules
34-
- **Library packages** (e.g., variants) → TypeScript and utility rules only
35-
- **Bootstrap package** (JavaScript tests) → Adjusted testing rules
36-
37-
## Repository-Specific Features
38-
39-
### Monorepo Awareness
40-
- **11 plugin packages** under `packages/`
41-
- **pnpm workspaces** configuration
42-
- **Shared utilities**: `@contentstack/cli-command`, `@contentstack/cli-utilities`
43-
- **Build artifacts**: `lib/` directories (excluded from rules)
44-
45-
### Actual Patterns Detected
46-
- **Testing**: Mocha + Chai + Sinon (not Jest)
47-
- **TypeScript**: Mixed strict mode adoption
48-
- **Commands**: Extend `@contentstack/cli-command` (not `@oclif/core`)
49-
- **Rate limiting**: Multiple mechanisms (batch spacing, 429 retry, pagination throttle)
50-
- **Coverage**: nyc with inconsistent enforcement
51-
52-
## Performance Benefits
53-
54-
- **75-85% token reduction** vs monolithic `.cursorrules`
55-
- **Context-aware loading** - only relevant rules activate based on actual file patterns
56-
- **Precise glob patterns** - avoid loading rules for build artifacts or irrelevant files
57-
- **Skills integration** - rules provide quick context, skills provide comprehensive patterns
58-
59-
## Design Principles
60-
61-
### Validated Against Codebase
62-
- Rules reflect **actual patterns** found in repository analysis
63-
- Glob patterns match **real file structure** (not theoretical)
64-
- Examples use **actual dependencies** and APIs
65-
- Coverage targets reflect **current enforcement** (aspirational vs actual)
66-
67-
### Lightweight and Focused
68-
- Each rule has **single responsibility**
69-
- Detailed patterns referenced via **skills system**
70-
- `alwaysApply: true` only for truly universal patterns
71-
- Package-specific variations acknowledged
72-
73-
## Validation Checklist
74-
75-
### Rule Loading Tests (Repository-Specific)
76-
-**Command files** (`packages/*/src/commands/**/*.ts`) → `oclif-commands.mdc` + `typescript.mdc` + `dev-workflow.md`
77-
-**Import modules** (`packages/contentstack-import/src/import/**/*.ts`) → `contentstack-cli.mdc` + `typescript.mdc` + `dev-workflow.md`
78-
-**Export modules** (`packages/contentstack-export/src/export/**/*.ts`) → `contentstack-cli.mdc` + `typescript.mdc` + `dev-workflow.md`
79-
-**Test files** (`packages/*/test/unit/**/*.test.ts`) → `testing.mdc` + `dev-workflow.md`
80-
-**Bootstrap tests** (`packages/contentstack-bootstrap/test/**/*.test.js`) → `testing.mdc` (JS-aware) + `dev-workflow.md`
81-
-**Service files** (`packages/*/src/services/**/*.ts`) → `contentstack-cli.mdc` + `typescript.mdc` + `dev-workflow.md`
82-
83-
### Manual Verification
84-
1. Open files from different packages in Cursor
85-
2. Check active rules shown in chat interface
86-
3. Verify correct rule combinations load based on file location
87-
4. Test manual rule invocation: `@contentstack-cli show me rate limiting patterns`
88-
5. Confirm no rules load for `lib/` build artifacts
89-
90-
### Performance Monitoring
91-
- **Before**: Monolithic rules loaded for all files
92-
- **After**: Context-specific rules based on actual file patterns
93-
- **Expected reduction**: 75-85% in token usage
94-
- **Validation**: Rules load only when relevant to current file context
95-
96-
## Maintenance Notes
97-
98-
### Regular Updates Needed
99-
- **Glob patterns** - Update when package structure changes
100-
- **TypeScript config** - Align with actual tsconfig.json variations
101-
- **Coverage targets** - Sync with actual nyc configuration
102-
- **Dependencies** - Update when shared utilities change
103-
104-
### Known Issues to Monitor
105-
- **Coverage typo**: Several `.nycrc.json` files have `"inlcude"` instead of `"include"`
106-
- **Strict mode inconsistency**: Packages have different TypeScript strictness levels
107-
- **Test patterns**: Bootstrap uses `.test.js` while others use `.test.ts`
5+
This folder only points contributors to **`AGENTS.md`** so editor-specific config does not duplicate the canonical docs.

.github/config/release.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
{
22
"releaseAll": true,
33
"plugins": {
4+
"asset-management": false,
45
"export": false,
56
"import": false,
67
"clone": false,

.github/workflows/release-v2-beta-plugins.yml

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,15 @@ jobs:
3838
filename: .github/config/release.json
3939
prefix: release
4040

41+
# Asset Management
42+
- name: Publishing asset-management (Beta)
43+
uses: JS-DevTools/npm-publish@v3
44+
with:
45+
token: ${{ secrets.NPM_TOKEN }}
46+
package: ./packages/contentstack-asset-management/package.json
47+
access: public
48+
tag: beta
49+
4150
# Variants
4251
- name: Publishing variants (Beta)
4352
uses: JS-DevTools/npm-publish@v3

.talismanrc

Lines changed: 83 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,86 @@
11
fileignoreconfig:
2+
- filename: packages/contentstack-import/src/utils/import-config-handler.ts
3+
checksum: 3194f537cee8041f07a7ea91cdc6351c84e400766696d9c3cf80b98f99961f76
24
- filename: pnpm-lock.yaml
3-
checksum: 0a12c6c1e4df121f6a217425ef0bd7b1acccc1cd3f972157f7ca7480281277fd
4-
- filename: .cursor/rules/contentstack-cli.mdc
5-
checksum: ba287a9e9dcf6565d2d2e79c9bbf6350a89e13afbd1f8755973d837563115c83
6-
- filename: .cursor/rules/dev-workflow.md
7-
checksum: ae8f8b2894c5cf0da6a85eb53c97775bd38835c191f9132ecaa24dcb9f439811
8-
- filename: .cursor/rules/oclif-commands.mdc
9-
checksum: 3f9891d3d5872a2823c83215bc1727911dd32935d17d91ad5f2e7d5f75f3ab61
5+
checksum: 3e5093383a595967f411433e1e5aa84f94bed84f2a6ba8d1af3075e24a6863e3
6+
- filename: packages/contentstack-export/src/export/modules/environments.ts
7+
checksum: a92c5de7ed8e80f08f911727973a66e0416b4a52265c275d1d25c3095f912811
8+
- filename: packages/contentstack-import/src/utils/backup-handler.ts
9+
checksum: 9a892b5c4b5aac230fb5969e7f34afdac0b6f96208e64bf9d1195468c935c66c
10+
- filename: packages/contentstack-import/test/unit/utils/backup-handler.test.ts
11+
checksum: 69860727e9b3099d8e1e95db2af17fc8b161684f675477981d27877cd8e1b3bb
12+
- filename: packages/contentstack-export/src/types/default-config.ts
13+
checksum: 5f0b0bb753242356edacb802241ec937a7741647813f9f347837368f08265667
14+
- filename: packages/contentstack-export/src/types/index.ts
15+
checksum: fa36c236abac338b03bf307102a99f25dddac9afe75b6b34fb82e318e7759799
16+
- filename: packages/contentstack-asset-management/.eslintrc
17+
checksum: 136f03481c8c59575d2eafd4c78d105119f85fb10fe88e02af8cffaf3eb7c090
18+
- filename: packages/contentstack-asset-management/src/import/asset-types.ts
19+
checksum: f65307b45623e2d0f17c2b0e26c34f92509850739757a0a9357a48a1c3e2234f
20+
- filename: packages/contentstack-audit/test/unit/logger-config.js
21+
checksum: 493e2e65939325f48d354469f409f1dbf84462adca995ed3a78461e80148d309
22+
- filename: packages/contentstack-export/test/unit/export/module-exporter.test.ts
23+
checksum: 67b70c93ed679ccb2c61d0c277380676e33c91da8a423f948e81937e5d1d9479
24+
- filename: packages/contentstack-asset-management/src/types/asset-management-api.ts
25+
checksum: 6629720575ab48371734d9455d591a431604b5afb2c5c682816e1571377a43ab
26+
- filename: packages/contentstack-export/test/unit/export/modules/assets.test.ts
27+
checksum: c4dc86b0973af171a11884e0bff9bb9ce5e41df68906d924588c0bf51b19ae9b
28+
- filename: packages/contentstack-export/test/unit/export/modules/base-class.test.ts
29+
checksum: 893a09567def9768c63310326e3bd35c2570bc436a9b9013147c6d383c949e11
30+
- filename: packages/contentstack-branches/src/branch/diff-handler.ts
31+
checksum: 3cd4d26a2142cab7cbf2094c9251e028467d17d6a1ed6daf22f21975133805f1
32+
- filename: packages/contentstack-audit/test/unit/base-command.test.ts
33+
checksum: 4208fae6e7cf1aeeb2b936d119c85cdc40e5e3560c7207e04bb94ba3e0305557
34+
- filename: packages/contentstack-export/test/unit/export/modules/marketplace-apps.test.ts
35+
checksum: 299b8f60cce1f64be7c20786d6a7c9c370474b97b06d1846114a76a70ec20cf7
36+
- filename: packages/contentstack-audit/src/modules/assets.ts
37+
checksum: b8b727867f8f6fb52ba18c33d158e1ee7bce9a15153c45becba6f73da16b5fcb
38+
- filename: packages/contentstack-export/src/export/modules/assets.ts
39+
checksum: 1d0ec8a15b35fb71261556e1982f53e7c940ddde49497f64d7a6fd7a7707bae4
40+
- filename: packages/contentstack-asset-management/src/types/export-types.ts
41+
checksum: 48add19a8466083905e15d6a8a925cd5341fa56cb945f91e411ffee9cd08975b
42+
- filename: packages/contentstack-export/test/unit/export/modules/stack.test.ts
43+
checksum: 79876b8f635037a2d8ba38dac055e7625bf85db6a3cf5729434e6a97e44857d6
44+
- filename: packages/contentstack-asset-management/src/export/base.ts
45+
checksum: 0fee8bb293b841dcf59ac5c566cb1b1b43a43e27041e7a9cdbee6f0e436c9598
46+
- filename: packages/contentstack-export/src/config/index.ts
47+
checksum: ae655e25cefff007c4ae4006c67b1529951350d9d2a3d179ef0a80d3da326d5a
48+
- filename: packages/contentstack-branches/src/branch/merge-handler.ts
49+
checksum: 4fd8dba9b723733530b9ba12e81e1d3e5d60b73ac4c082defb10593f257bb133
50+
- filename: packages/contentstack-asset-management/src/utils/asset-management-api-adapter.ts
51+
checksum: 256ddcfbb10ee4ccfac2ea5c2d733199f8830a78896196d1e965109942b234e8
52+
- filename: packages/contentstack-import/src/types/default-config.ts
53+
checksum: 1c09acba953cfd7058a3e0d63f0a9bfbb8f28e903538eaa015fdc611402bbd4f
54+
- filename: packages/contentstack-asset-management/src/utils/export-helpers.ts
55+
checksum: 1a0a04d5d86a07307122c5b160d8c3a831f0e17b7a1d2b5aaf16b1a73e231981
56+
- filename: packages/contentstack-import/src/utils/build-import-spaces-options.ts
57+
checksum: fe0cb6cb5903515982af1e3642f2a19233207d35f13dc205cebeda0aa399f8b5
58+
- filename: packages/contentstack-branches/src/commands/cm/branches/merge-status.ts
59+
checksum: 6e5b959ddcc5ff68e03c066ea185fcf6c6e57b1819069730340af35aad8a93a8
60+
- filename: packages/contentstack-asset-management/src/import/spaces.ts
61+
checksum: e607b8a9e42ffab01ba328272cf27106ed2728856ecbe0d6ed791e72d70a27fe
62+
- filename: packages/contentstack-asset-management/src/import/assets.ts
63+
checksum: 20d51c63e9c00783caa3eba9239879e687b34637105c9539be667439e9fa64ab
64+
- filename: packages/contentstack-branches/src/utils/create-branch.ts
65+
checksum: d0613295ee26f7a77d026e40db0a4ab726fabd0a74965f729f1a66d1ef14768f
66+
- filename: packages/contentstack-asset-management/src/import/base.ts
67+
checksum: 0c7ff03a094e9d84710752ee875421e9a21dcc088f56286aa172a96127ad5f8e
68+
- filename: packages/contentstack-asset-management/test/unit/utils/asset-management-api-adapter.test.ts
69+
checksum: ff688f37f40de3f7cbef378ec682ca1167720d902d8d84370464af7feb36c124
70+
- filename: packages/contentstack-asset-management/src/import/fields.ts
71+
checksum: 09f528b7af3db71f4d939f3768c4760a95c2593c3ee93a7cb568d41f1dbaa71c
72+
- filename: packages/contentstack-asset-management/test/unit/utils/export-helpers.test.ts
73+
checksum: 0e8751163491fc45e7ae3999282d336ae1ab8a9f88e601cbb85b4f44e8db96b8
74+
- filename: packages/contentstack-export/src/export/modules/stack.ts
75+
checksum: 00774a601a5d2b4a47a91fe5bbb0ea9c93c48fa785ee9887c0d74a6b6ec21296
76+
- filename: packages/contentstack-audit/test/unit/modules/entries.test.ts
77+
checksum: aaf2e125c5e93ab15364e41559390502a18b83a4b3de5879c02572969381c0a6
78+
- filename: packages/contentstack-asset-management/test/unit/export/base.test.ts
79+
checksum: 164fc2e5a4337a2739903499b66eecc66a85bb9b50aa2e71079bdd046a195a94
80+
- filename: skills/code-review/SKILL.md
81+
checksum: 29673e16f6b41fcec7fa236912e7f72b920ed4a3d9a66a89308b4a058b247f3e
82+
- filename: skills/contentstack-cli/SKILL.md
83+
checksum: 36762d43bbacedd0b344f9d4f1179a88e3dbc7e2467341ba42198dcd1bf9e40c
84+
- filename: skills/testing/SKILL.md
85+
checksum: ee1c82f1bb51860cb26fb9f112a53df0127e316fcb22a094034024741251fa3c
1086
version: '1.0'

AGENTS.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Contentstack CLI plugins – Agent guide
2+
3+
**Universal entry point** for contributors and AI agents. Detailed conventions live in **`skills/*/SKILL.md`**.
4+
5+
## What this repo is
6+
7+
| Field | Detail |
8+
| --- | --- |
9+
| **Name:** | Contentstack CLI plugins (pnpm monorepo; root package name `csdx`) |
10+
| **Purpose:** | OCLIF plugins that extend the Contentstack CLI (import/export, clone, migration, seed, audit, variants, etc.). |
11+
| **Out of scope (if any):** | The **core** CLI aggregation lives in the separate `cli` monorepo; this repo ships plugin packages only. |
12+
13+
## Tech stack (at a glance)
14+
15+
| Area | Details |
16+
| --- | --- |
17+
| **Language** | TypeScript / JavaScript, Node **>= 18** (`engines` in root `package.json`) |
18+
| **Build** | pnpm workspaces (`packages/*`); per package: `tsc`, OCLIF manifest/readme where applicable → `lib/` |
19+
| **Tests** | Mocha + Chai; layouts under `packages/*/test/` (see [skills/testing/SKILL.md](skills/testing/SKILL.md)) |
20+
| **Lint / coverage** | ESLint in packages that define `lint` scripts; nyc where configured |
21+
| **Other** | OCLIF v4, Husky |
22+
23+
## Commands (quick reference)
24+
25+
| Command type | Command |
26+
| --- | --- |
27+
| **Build** | `pnpm build` |
28+
| **Test** | `pnpm test` |
29+
| **Lint** | `pnpm run lint` in a package that defines `lint` (no root aggregate lint script) |
30+
31+
CI: [.github/workflows/unit-test.yml](.github/workflows/unit-test.yml) and other workflows under [.github/workflows/](.github/workflows/).
32+
33+
## Where the documentation lives: skills
34+
35+
| Skill | Path | What it covers |
36+
| --- | --- | --- |
37+
| Development workflow | [skills/dev-workflow/SKILL.md](skills/dev-workflow/SKILL.md) | pnpm commands, CI, TDD expectations, PR checklist |
38+
| Contentstack CLI | [skills/contentstack-cli/SKILL.md](skills/contentstack-cli/SKILL.md) | Plugin commands, OCLIF, Contentstack APIs |
39+
| Framework | [skills/framework/SKILL.md](skills/framework/SKILL.md) | Utilities, config, logging, errors |
40+
| Testing | [skills/testing/SKILL.md](skills/testing/SKILL.md) | Mocha/Chai, coverage, mocks |
41+
| Code review | [skills/code-review/SKILL.md](skills/code-review/SKILL.md) | PR review for this monorepo |
42+
43+
## Using Cursor (optional)
44+
45+
If you use **Cursor**, [.cursor/rules/README.md](.cursor/rules/README.md) only points to **`AGENTS.md`**—same docs as everyone else.

0 commit comments

Comments
 (0)