You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 1fcfd30
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
# CodeAppsCompact
2
2
3
-
**Install one skill. Its record-screen kit is already included.**
3
+
**Install one skill. Its record-screen kit is already included as a ZIP.**
4
4
5
5
CodeAppsCompact helps an agent build Power Platform Code Apps by configuring a reusable React/TypeScript screen instead of rewriting its list, form, paging, validation, and error handling.
6
6
7
-
**0.1.2 - experimental, MIT-licensed.** Distributed through GitHub, not the npm registry. Live Power Apps-host and tenant compatibility remain unverified. This release changes packaging, not component behavior.
7
+
**0.1.3 - experimental, MIT-licensed.** Distributed through GitHub, not the npm registry. Live Power Apps-host and tenant compatibility remain unverified. This release changes packaging, not component behavior.
**Other Agent Skills hosts:** import [codeappscompact-skill-0.1.2.zip](https://github.com/ilyafainberg/CodeAppsCompact/releases/download/v0.1.2/codeappscompact-skill-0.1.2.zip), or copy the complete [skill folder](plugins/codeappscompact/skills/codeappscompact) through your host's supported mechanism. Preserve `assets` and `references`; importing only the text of `SKILL.md` is insufficient. Existing users must update or reinstall the complete skill to receive the bundle. Reload the host if it requires a new session.
27
+
**Other Agent Skills hosts:** import [codeappscompact-skill-0.1.3.zip](https://github.com/ilyafainberg/CodeAppsCompact/releases/download/v0.1.3/codeappscompact-skill-0.1.3.zip), or copy the complete [skill folder](plugins/codeappscompact/skills/codeappscompact) through your host's supported mechanism. Preserve `assets` and `references`; importing only the text of `SKILL.md` is insufficient. Existing users must update or reinstall the complete skill to receive the ZIP bundle. Reload the host if it requires a new session.
28
28
29
29
The skill contains everything specific to CodeAppsCompact:
30
30
@@ -36,18 +36,18 @@ codeappscompact/
36
36
install.md
37
37
kit.json
38
38
assets/
39
-
codeappscompact-0.1.2.tgz
39
+
codeappscompact-0.1.3.zip
40
40
```
41
41
42
-
The archive includes prebuilt JavaScript, TypeScript declarations, `API.txt`, a synthetic example, package metadata, and the MIT license. No separate kit download or source build is needed.
42
+
The ZIP includes prebuilt JavaScript, TypeScript declarations, `API.txt`, a synthetic example, package metadata, and the MIT license. No separate kit download or source build is needed.
43
43
44
44
## Use it
45
45
46
46
In an existing React/TypeScript Code App, ask:
47
47
48
48
> Use CodeAppsCompact to add a service-request screen using our existing generated service. Include summary, owner email, priority, and estimated hours. Support creating, editing, paging, and searching loaded records. Preserve the theme and do not deploy.
49
49
50
-
The agent reuses a supported installed kit. If absent, it verifies the bundled archive, copies it into the app's `vendor` directory, and installs that local file with the app's package manager. It then reads the installed API and writes only your fields, columns, validation, and typed service adapter. Keep the vendored archive, dependency manifest, and lockfile together in the app repository.
50
+
The agent reuses a supported installed kit. If absent, it verifies the bundled ZIP, extracts it into the app's `vendor` directory, and installs the extracted package folder with the app's package manager. npm cannot install a ZIP directly. The agent then reads the installed API and writes only your fields, columns, validation, and typed service adapter. Keep the entire extracted package directory, dependency manifest, and lockfile together in the app repository; the skill's ZIP is not needed for subsequent restores.
51
51
52
52
The skill assumes its assets are present. An incomplete or corrupt installation is an error: reinstall the complete skill rather than fetching a substitute or regenerating the component. Existing locked dependencies and custom packages are not silently replaced.
Copy file name to clipboardExpand all lines: kit/README.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,12 +1,12 @@
1
1
# CodeAppsCompact kit maintenance
2
2
3
-
This directory is for maintainers. Consumers install the self-contained skill from [CodeAppsCompact](https://github.com/ilyafainberg/CodeAppsCompact), which already includes the built kit. They do not clone or build this directory.
3
+
This directory is for maintainers. Consumers install the self-contained skill from [CodeAppsCompact](https://github.com/ilyafainberg/CodeAppsCompact), which already includes the built kit as a ZIP. They do not clone or build this directory.
4
4
5
5
The `codeappscompact` package exports `RecordScreen` and its TypeScript contracts. See [API.txt](API.txt) for the full behavior and [examples/App.tsx](examples/App.tsx) for configuration. [examples/main.tsx](examples/main.tsx) supplies the caller-owned query provider; [examples/service.ts](examples/service.ts) is synthetic. The package injects no styles, creates no query client, and performs no direct network requests.
6
6
7
7
## Develop
8
8
9
-
Use Node.js >=22.12.0; CI uses Node.js 24. From this directory:
9
+
Use Node.js >=22.12.0 and PowerShell 7 (`pwsh`); both are available in the Linux CI image. ZIP creation and distribution tests use PowerShell's built-in .NET ZIP support, with no additional archive package. Consumers can use any safe ZIP extractor. From this directory:
10
10
11
11
```powershell
12
12
npm ci --ignore-scripts --no-audit --no-fund
@@ -16,23 +16,23 @@ npm run build:demo
16
16
npm run dev
17
17
```
18
18
19
-
The synthetic demo runs at Vite's loopback URL, uses in-memory data, makes no tenant requests, and resets on reload. These commands do not publish or deploy. `npm test` builds the library before comparing the checked-in skill archive to the current source. After intentional package changes, regenerate that archive with `npm run bundle:skill` before testing.
19
+
The synthetic demo runs at Vite's loopback URL, uses in-memory data, makes no tenant requests, and resets on reload. These commands do not publish or deploy. `npm test` builds the library before comparing the checked-in skill ZIP to the current source. After intentional package changes, regenerate that ZIP with `npm run bundle:skill` before testing.
20
20
21
21
## Update the bundle
22
22
23
23
1. Update the package/lockfile, both marketplace catalogs, both plugin manifests, skill version, documentation filenames, and skill's `references\kit.json` together. Review supported installed versions instead of assuming compatibility. Keep npm publishing disabled (`private: true`).
24
-
2. Remove only the previous tracked kit archive when changing its version. Run `npm run bundle:skill`. It builds the library, packs the allowlisted consumer files into the skill's `assets`directory, and records their SHA-256 in `kit.json`. The component, declarations, API, example, README, and license all travel inside that archive; no separate kit release is needed.
25
-
3. Run type checking, tests, and the demo build. Review the archive and the git diff, including the generated manifest. Distribution tests compare the archive to the current build and documentation, verify its digest and metadata, and reject extra packaged files. They use the system `tar` command (available in current Windows and the Linux CI image).
26
-
4. Commit the complete skill bundle with its source. Package the entire skill directory into `codeappscompact-skill-<version>.zip`, with one top-level `codeappscompact` folder. Include `assets`, `references`, `SKILL.md`, and LICENSE. Exercise installation from that ZIP in an isolated consumer, including a clean lockfile restore without the original skill directory.
24
+
2. Remove only the previous tracked kit archive when changing its version. Run `npm run bundle:skill`. It builds the library, packages the explicit consumer-file allowlist into the skill's `assets`ZIP, and records its SHA-256 in `kit.json`. ZIP entries use a fixed timestamp. The component, declarations, API, example, README, and license all travel inside that ZIP; no separate kit release is needed.
25
+
3. Run type checking, tests, and the demo build. Review the ZIP and the git diff, including the generated manifest. Distribution tests open the ZIP, compare its contents to the current build and documentation, verify its digest and metadata, and reject extra packaged filesand links.
26
+
4. Commit the complete skill bundle with its source. Package the entire skill directory into `codeappscompact-skill-<version>.zip`, with one top-level `codeappscompact` folder. Include `assets`, `references`, `SKILL.md`, and LICENSE. Exercise ZIP extraction and local-directory installation in an isolated consumer, including a clean lockfile restore without the original skill directory or ZIP.
27
27
5. Publish the skill ZIP on a new GitHub release tag pointing to the reviewed commit. Do not replace an existing release's artifacts. Confirm the public ZIP matches the reviewed bundle. Marketplace installs receive the same checked-in assets; portable users need only the skill ZIP. No npm publishing, automatic updates, install hooks, telemetry, or tenant changes are involved.
28
28
29
29
The repository-root `marketplace.json` and `.claude-plugin\marketplace.json` represent the same catalog. The plugin has Agent Plugins 1.0 and legacy manifests. Keep both pairs synchronized.
30
30
31
31
## Consumer boundaries
32
32
33
-
The skill verifies and copies its local archive into the app's `vendor` directory, then uses the app's package manager. Retain that archive with the app's manifest and lockfile; do not reference the agent's installation directory. Ordinary React, TanStack React Query, and Power Apps SDK dependencies remain external. The package is not published to npm; a registry package with the same name is not evidence of this project's provenance.
33
+
The skill verifies and extracts its local ZIP into the app's `vendor` directory, then installs the extracted package directory with the app's package manager. npm does not install ZIP files directly. Retain the complete extracted directory with the app's manifest and lockfile; do not reference the agent's installation directory or rely on a ZIP for lockfile restores. Ordinary React, TanStack React Query, and Power Apps SDK dependencies remain external. The package is not published to npm; a registry package with the same name is not evidence of this project's provenance.
34
34
35
-
Only flat string/number record drafts and read/create/update screens are supplied. Authentication, SDK setup, connections, permissions, schema, styling, query-provider ownership, and deployment belong to the app. Neither the example nor these tests establish live Power Apps-host or tenant compatibility. Version 0.1.2 changes packaging, not component behavior.
35
+
Only flat string/number record drafts and read/create/update screens are supplied. Authentication, SDK setup, connections, permissions, schema, styling, query-provider ownership, and deployment belong to the app. Neither the example nor these tests establish live Power Apps-host or tenant compatibility. Version 0.1.3 changes packaging, not component behavior.
0 commit comments