@hagicode/hagitask 0.1.0-dev.6

package/README.md

@@ -0,0 +1,241 @@
+# hagitask
+
+HagiTask is the canonical repository for preset-task contribution assets inside the
+HagiCode monorepo. It is the maintained source of truth for shipped preset-task
+schemas and preset packages.
+
+## npm CLI
+
+The repository is also published as `@hagicode/hagitask` (Node.js 20 or newer).
+Install it with `npm install --save-dev @hagicode/hagitask`, then validate a
+repository or one package:
+
+```bash
+npx hagitask validate .
+npx hagitask validate ./data/my-task --json
+```
+
+`validate` discovers packages directly under `presets/` and `data/`, or validates
+a directory containing `manifest.json`. It returns exit code `0` only when all
+discovered packages pass. Human-readable diagnostics are printed by default;
+`--json` prints the stable `{ packages, errors, valid }` result on stdout for CI.
+Validation reads `schemas/` shipped inside the npm package (and never requires a
+network connection). The CLI is the new reusable validator; Contrib and Community
+Packages retain their existing workflows until a separate migration.
+
+> Authoring location: contributors add and update preset-task packages **here**, in
+> `repos/hagitask`, not in `repos/hagicode-core/src/PCode.Web/plugins/task-presets/`.
+> The `hagicode-core` copy is a transitional asset that is kept only until the backend
+> loading cutover lands.
+
+## Repository Layout
+
+```text
+repos/hagitask/
+  schemas/
+    task-preset-plugin/
+      manifest.schema.json        # Preset package manifest contract
+      panel.schema.json           # Frontend panel definition contract
+      commands.schema.json        # Frontend command catalog contract
+      locales.schema.json         # Locale bundle contract
+      task-preset.schema.json     # Backend task-preset contract
+      prompt-package.schema.json  # Backend prompt package contract
+      store-page-frontmatter.schema.json  # Store-page frontmatter contract
+    community-index-v1.schema.json        # Published /index.json contract
+    community-task-detail-v1.schema.json  # Published /tasks/<taskId>.json contract
+  presets/
+    <presetTaskId>/
+      manifest.json
+      frontend/
+        panel.json
+        commands.json             # Optional, only when the preset ships commands
+      backend/
+        task-preset.json
+        prompts.json
+        templates/<locale>/...
+      locales/
+        en-US.json
+        zh-CN.json
+      store-page/
+        index.en-US.md
+        index.zh-CN.md
+```
+
+## Schema Layers
+
+`schemas/` holds three schema layers. They validate different documents, at different
+points in the pipeline, and are owned by different producers.
+
+| Layer | Schemas | Validates | Produced by |
+| --- | --- | --- | --- |
+| Package schemas | `schemas/task-preset-plugin/*.schema.json` | the JSON files inside a preset or community package (`manifest.json`, `frontend/*`, `backend/*`, `locales/*`) | contributors, by hand |
+| Community discovery schema | `schemas/community-index-v1.schema.json` | the published `/index.json` catalog | `hagitask-site` build |
+| Community detail schema | `schemas/community-task-detail-v1.schema.json` | each published `/tasks/<taskId>.json` document | `hagitask-site` build |
+
+Package schemas describe **authored source**. The community schemas describe
+**generated publication output** and carry fields that do not exist in any package file
+(`generatedAt`, `detailUrl`, `packageUrl`, `integrity.sha256`, and so on). Choosing the
+wrong layer is the most common source of confusion: if you are editing a file inside a
+package directory, the matching contract is always under `schemas/task-preset-plugin/`.
+
+Community packages live in
+[`hagitask-community-packages`](https://github.com/HagiCode-org/hagitask-community-packages).
+That repository mounts HagiTask as a **nested submodule** and consumes these schemas
+directly from `hagitask/schemas/task-preset-plugin/` — it no longer vendors its own copy.
+[`hagitask-site`](https://github.com/HagiCode-org/hagitask-site) in turn mounts the
+community repository as its `community-packages/` submodule, reads task packages from
+`community-packages/data/`, and loads the publication schemas from
+`community-packages/hagitask/schemas`. Shipped presets live in `presets/` in this
+repository. All three — HagiTask presets, community packages, and the site build — use the
+same package schemas from this directory.
+
+## Package `$schema` Reference
+
+`schemas/task-preset-plugin/` is the authoritative home for the JSON schemas that
+validate preset packages. Every shipped and community preset package resolves its
+`$schema` references against this directory, so contributors never need files from
+`repos/hagicode-core` to validate a package.
+
+The shipped preset packages use these relative `$schema` paths from inside
+`presets/<presetTaskId>/`:
+
+| Package file                       | `$schema` path                                                          |
+|------------------------------------|-------------------------------------------------------------------------|
+| `manifest.json`                    | `../../schemas/task-preset-plugin/manifest.schema.json`                 |
+| `frontend/panel.json`              | `../../../schemas/task-preset-plugin/panel.schema.json`                 |
+| `frontend/commands.json`           | `../../../schemas/task-preset-plugin/commands.schema.json`              |
+| `backend/task-preset.json`         | `../../../schemas/task-preset-plugin/task-preset.schema.json`           |
+| `backend/prompts.json`             | `../../../schemas/task-preset-plugin/prompt-package.schema.json`        |
+| `locales/<locale>.json`            | `../../../schemas/task-preset-plugin/locales.schema.json`               |
+
+Prompt packages may optionally declare `commandSystemPrompts`, mapping a command id
+to locale-specific system-template paths:
+
+```json
+{
+  "commandSystemPrompts": {
+    "initialize": {
+      "en-US": "./templates/en-US/commands/initialize.md",
+      "zh-CN": "./templates/zh-CN/commands/initialize.md"
+    }
+  }
+}
+```
+
+The selected command template is rendered with the same context as the user and
+base system templates. Locale resolution uses an exact match, then the language
+portion, then the package default locale. Missing mappings, blank commands, and
+legacy packages simply omit the additional system section. Final prompt order is
+user prompt, command-specific system prompt, then base system prompt; existing
+command preludes remain supported.
+
+Community packages use the identical values, so a package can move between
+`presets/<presetTaskId>/` and the community repository without rewriting references.
+
+## Publication Data Flow
+
+```mermaid
+flowchart LR
+    SRC["Community package source<br/>data/&lt;taskId&gt;/manifest.json, frontend/, backend/, locales/, store-page/"]
+    PKG["Package schemas<br/>hagitask/schemas/task-preset-plugin/*.schema.json"]
+    SUB["hagitask-site community-packages/ submodule (nested hagitask)"]
+    NORM["Site build: normalize + digest"]
+    IDX["/index.json"]
+    DET["/tasks/&lt;taskId&gt;.json"]
+    ZIP["/packages/&lt;taskId&gt;.zip"]
+    CIDX["community-index-v1.schema.json"]
+    CDET["community-task-detail-v1.schema.json"]
+
+    PKG -.validates.-> SRC
+    SRC --> SUB --> NORM
+    NORM --> IDX
+    NORM --> DET
+    NORM --> ZIP
+    CIDX -.validates.-> IDX
+    CDET -.validates.-> DET
+```
+
+How source edits reach the published documents:
+
+| Source change | Affected published fields |
+| --- | --- |
+| `manifest.json` → `version` | `version` in index and detail |
+| `manifest.json` → `owner` | `publisher` in index and detail |
+| `backend/task-preset.json` → `requirements` | `requirements` in detail, and the derived `compatibility.agent` / `.skills` / `.cli` in both documents |
+| `store-page/index.<locale>.md` → `title` / `summary` | `name`, `summary`, `description`, and `localization.supportedLocales` |
+| `store-page/index.en-US.md` → `catalog` / `tags` | `category` and `tags` |
+| any file in the package directory | the zip contents, plus `integrity.sha256` in the index and `installation.size` / `installation.sha256` in the detail |
+
+## Generated Output Is Not Editable
+
+`/index.json`, `/tasks/<taskId>.json`, and `/packages/<taskId>.zip` are produced from
+scratch on every site build. They are not stored in any repository as editable source and
+hand edits are discarded on the next publish. The only way to change a published field is
+to change the package file it is derived from.
+
+When schema validation fails:
+
+1. Read which document failed. A `task-preset-plugin` failure points at a package file you
+   authored; a `community-index-v1` or `community-task-detail-v1` failure means the site
+   build normalized your source into something that violates the publication contract.
+2. Fix the source package file. Do not relax `$schema`, delete the `$schema` reference,
+   skip validation, or patch the generated output.
+3. Re-run the site build to confirm the fix.
+4. If the package data is genuinely correct and the schema is wrong, change the schema
+   **here**, in this repository, as a deliberate contract change.
+
+## Preset Package Directory
+
+`presets/` is the root for preset-task packages. Each package lives in its own
+`presets/<presetTaskId>/` directory and preserves the loader-compatible plugin
+package shape (`manifest.json`, `frontend/`, `backend/`, `locales/`, and
+`store-page/`). This means the backend can load migrated packages without a
+HagiTask-specific adapter.
+
+Currently shipped packages:
+
+- `normal-session`
+- `research-investigation`
+
+`agents-md-update`, `goal`, `last30days`, `openspec-spec-compress`, `ponytail`, and
+`ui-master` are published as community tasks and live in
+[`hagitask-community-packages`](https://github.com/HagiCode-org/hagitask-community-packages),
+not in `presets/`.
+
+## Source-of-Truth Ownership
+
+HagiTask owns preset-task schemas and shipped preset packages. When you add a new
+preset, update an existing one, or change a schema, do it here.
+
+The legacy copies under `repos/hagicode-core/src/PCode.Web/plugins/task-presets/`
+are kept unchanged during the copy-first transition phase. After the later backend
+loading cutover (see `openspec/changes/migrate-preset-task-to-hagitask-repo`),
+`hagicode-core` will load shipped presets from `repos/hagitask/presets` through the
+`TaskPresetPlugins.PresetGroups` configuration and the backend-owned copy will no
+longer be the shipped source of truth.
+
+Until that cutover lands, every shipped preset update — including `openspec-spec-compress` —
+must keep the `hagicode-core` runtime copy synchronized with the canonical HagiTask package.
+
+## Contributing a Preset Package
+
+HagiTask owns the Schema and shipped preset source. Preset packages use the loader-compatible
+layout described above and must keep their JSON resources aligned with
+`schemas/task-preset-plugin/`. Validate authored files against those schemas before submitting:
+
+```bash
+npm run validate
+```
+
+The validator checks every shipped preset, all manifest resource references, package
+JSON schemas, prompt template references, and compatibility binding aliases. It is
+intentionally package-local so the same command can run in a clean checkout without
+depending on Core or site-generated output.
+
+For the user-facing walkthrough covering package creation, locale and store-page resources,
+validation, semantic versioning, and Pull Requests, see the
+[HagiTask community guide](https://docs.hagicode.com/guides/hagitask/community/). A community
+task belongs in
+[`hagitask-community-packages`](https://github.com/HagiCode-org/hagitask-community-packages),
+not in this repository. This README remains the technical reference for Schema ownership,
+preset source data, and the transitional runtime copy.

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+export declare function createCli(): Command;
+export declare function main(argv?: string[]): void;

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runValidateCommand } from './commands/validate-command.js';
+function packageVersion() {
+    try {
+        const packagePath = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+        return JSON.parse(readFileSync(packagePath, 'utf8')).version;
+    }
+    catch {
+        return '0.1.0';
+    }
+}
+export function createCli() {
+    const program = new Command();
+    program
+        .name('hagitask')
+        .description('Validate HagiTask preset and community packages offline.')
+        .version(packageVersion());
+    program
+        .command('validate [path]')
+        .description('validate packages under presets/, data/, or a single package directory')
+        .option('--json', 'print machine-readable JSON diagnostics')
+        .action((path, options) => {
+        process.exitCode = runValidateCommand(path ?? process.cwd(), options);
+    });
+    return program;
+}
+export function main(argv = process.argv) {
+    createCli().parse(argv);
+}
+if (import.meta.url === `file://${process.argv[1]}`)
+    main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,0DAA0D,CAAC;SACvE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,wEAAwE,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,yCAAyC,CAAC;SAC3D,MAAM,CAAC,CAAC,IAAwB,EAAE,OAA2B,EAAE,EAAE;QAChE,OAAO,CAAC,QAAQ,GAAG,kBAAkB,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IACL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IACtC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC"}

package/dist/commands/validate-command.d.ts

@@ -0,0 +1,4 @@
+export interface ValidateCommandOptions {
+    json?: boolean;
+}
+export declare function runValidateCommand(path?: string, options?: ValidateCommandOptions): number;

package/dist/commands/validate-command.js

@@ -0,0 +1,14 @@
+import { validatePackages } from '../index.js';
+import { formatValidationText } from '../validation/diagnostics.js';
+export function runValidateCommand(path = process.cwd(), options = {}) {
+    const result = validatePackages(path);
+    const output = options.json
+        ? JSON.stringify(result, null, 2)
+        : formatValidationText(result);
+    if (options.json || result.valid)
+        console.log(output);
+    else
+        console.error(output);
+    return result.valid ? 0 : 1;
+}
+//# sourceMappingURL=validate-command.js.map

package/dist/commands/validate-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-command.js","sourceRoot":"","sources":["../../src/commands/validate-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAMpE,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,UAAkC,EAAE;IAC3F,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI;QACzB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;;QACjD,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export type { DiscoveredPackage, DiscoveryResult } from './validation/package-discovery.js';
+export type { ValidationError, ValidationResult } from './validation/diagnostics.js';
+export declare const PACKAGE_NAME = "@hagicode/hagitask";
+export declare const PACKAGE_VERSION = "0.1.0";
+export declare const packageMetadata: {
+    readonly name: "@hagicode/hagitask";
+    readonly version: "0.1.0";
+};
+export interface ValidateOptions {
+    /** Override the directory containing the published schemas. */
+    packageRoot?: string;
+}
+export declare function validatePackages(targetPath?: string, options?: ValidateOptions): import("./validation/diagnostics.js").ValidationResult;
+export { discoverPackages } from './validation/package-discovery.js';
+export { formatValidationError, formatValidationText } from './validation/diagnostics.js';

package/dist/index.js

@@ -0,0 +1,31 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { discoverPackages } from './validation/package-discovery.js';
+import { validateDiscoveredPackages } from './validation/package-validator.js';
+export const PACKAGE_NAME = '@hagicode/hagitask';
+export const PACKAGE_VERSION = '0.1.0';
+export const packageMetadata = {
+    name: PACKAGE_NAME,
+    version: PACKAGE_VERSION,
+};
+export function validatePackages(targetPath = process.cwd(), options = {}) {
+    const root = resolve(targetPath);
+    const discovery = discoverPackages(root);
+    const packageRoot = options.packageRoot ?? resolve(dirname(fileURLToPath(import.meta.url)), '..');
+    if (discovery.errors.length > 0) {
+        return {
+            packages: discovery.packages.map((pkg) => pkg.rel).sort(),
+            errors: discovery.errors.map((message) => ({
+                packageId: '',
+                file: root,
+                field: 'path',
+                message,
+            })),
+            valid: false,
+        };
+    }
+    return validateDiscoveredPackages(discovery.packages, root, packageRoot);
+}
+export { discoverPackages } from './validation/package-discovery.js';
+export { formatValidationError, formatValidationText } from './validation/diagnostics.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAI/E,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,eAAe;CAChB,CAAC;AAOX,MAAM,UAAU,gBAAgB,CAC9B,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,EAC1B,UAA2B,EAAE;IAE7B,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAClG,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;YACzD,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACzC,SAAS,EAAE,EAAE;gBACb,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,MAAM;gBACb,OAAO;aACR,CAAC,CAAC;YACH,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;IACD,OAAO,0BAA0B,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC3E,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/validation/diagnostics.d.ts

@@ -0,0 +1,13 @@
+export interface ValidationError {
+    packageId: string;
+    file: string;
+    field: string;
+    message: string;
+}
+export interface ValidationResult {
+    packages: string[];
+    errors: ValidationError[];
+    valid: boolean;
+}
+export declare function formatValidationError(error: ValidationError): string;
+export declare function formatValidationText(result: ValidationResult): string;

package/dist/validation/diagnostics.js

@@ -0,0 +1,16 @@
+export function formatValidationError(error) {
+    return `${error.packageId}: ${error.file}: ${error.field}: ${error.message}`;
+}
+export function formatValidationText(result) {
+    const lines = [
+        `HagiTask package validation ${result.valid ? 'passed' : 'failed'}`,
+        `Packages discovered: ${result.packages.length}`,
+        `Packages: ${result.packages.join(', ') || '(none)'}`,
+        `Errors: ${result.errors.length}`,
+    ];
+    if (result.errors.length > 0) {
+        lines.push('', ...result.errors.map((error) => `- ${formatValidationError(error)}`));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/validation/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/validation/diagnostics.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,OAAO,GAAG,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAwB;IAC3D,MAAM,KAAK,GAAG;QACZ,+BAA+B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;QACnE,wBAAwB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QAChD,aAAa,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE;QACrD,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;KAClC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/validation/package-discovery.d.ts

@@ -0,0 +1,10 @@
+export interface DiscoveredPackage {
+    dirName: string;
+    dir: string;
+    rel: string;
+}
+export interface DiscoveryResult {
+    packages: DiscoveredPackage[];
+    errors: string[];
+}
+export declare function discoverPackages(targetPath: string): DiscoveryResult;

package/dist/validation/package-discovery.js

@@ -0,0 +1,45 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+function packageInDir(dir, rel) {
+    if (!statSync(dir, { throwIfNoEntry: false })?.isDirectory())
+        return undefined;
+    if (!existsSync(join(dir, 'manifest.json')))
+        return undefined;
+    return { dirName: basename(dir), dir, rel };
+}
+export function discoverPackages(targetPath) {
+    const root = resolve(targetPath);
+    if (!existsSync(root)) {
+        return { packages: [], errors: [`target path does not exist: ${root}`] };
+    }
+    if (!statSync(root).isDirectory()) {
+        return { packages: [], errors: [`target path is not a directory: ${root}`] };
+    }
+    const direct = packageInDir(root, basename(root));
+    if (direct)
+        return { packages: [direct], errors: [] };
+    const layouts = ['presets', 'data'].filter((name) => {
+        const path = join(root, name);
+        return existsSync(path) && statSync(path).isDirectory();
+    });
+    if (layouts.length === 0) {
+        return {
+            packages: [],
+            errors: [`unsupported package layout at ${root}; expected presets/<taskId>/, data/<taskId>/, or a package directory containing manifest.json`],
+        };
+    }
+    const packages = [];
+    for (const layout of layouts) {
+        const layoutDir = join(root, layout);
+        for (const entry of readdirSync(layoutDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const pkg = packageInDir(join(layoutDir, entry.name), `${layout}/${entry.name}`);
+            if (pkg)
+                packages.push(pkg);
+        }
+    }
+    packages.sort((a, b) => a.rel.localeCompare(b.rel));
+    return { packages, errors: [] };
+}
+//# sourceMappingURL=package-discovery.js.map

package/dist/validation/package-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-discovery.js","sourceRoot":"","sources":["../../src/validation/package-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAY,OAAO,EAAE,MAAM,WAAW,CAAC;AAa9D,SAAS,YAAY,CAAC,GAAW,EAAE,GAAW;IAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE;QAAE,OAAO,SAAS,CAAC;IAC/E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9D,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,+BAA+B,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAClC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,mCAAmC,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/E,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAEtD,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,CAAC,iCAAiC,IAAI,+FAA+F,CAAC;SAC/I,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACpE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACjF,IAAI,GAAG;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAClC,CAAC"}

package/dist/validation/package-validator.d.ts

@@ -0,0 +1,4 @@
+import type { DiscoveredPackage } from './package-discovery.js';
+import type { ValidationError, ValidationResult } from './diagnostics.js';
+export declare function validatePackage(pkg: DiscoveredPackage, targetRoot: string, packageRoot: string): ValidationError[];
+export declare function validateDiscoveredPackages(packages: DiscoveredPackage[], targetRoot: string, packageRoot: string): ValidationResult;