@hagicode/hagitask 0.1.0-dev.10

package/README.md

@@ -0,0 +1,260 @@
+# 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
+```
+
+Create a new package scaffold without network access:
+
+```bash
+npx hagitask new my-task
+npx hagitask new my-task --target ./data/my-task --repository repos/web repos/hagicode-core
+```
+
+The target directory must be empty (or absent), and package names use lowercase
+letters, numbers, and hyphens. `--target` selects the exact package directory (its final directory name must match the package name);
+`--destination` and `--output` are aliases. `--repository` may be repeated or
+followed by multiple identifiers and only populates the repository selector
+options; commands still require an explicit `targetRepositories` selection.
+
+Generated packages contain `manifest.json`, `frontend/`, `backend/`, bilingual
+`locales/`, `store-page/`, and `commands/README.md`. The baseline commands
+`what is this` explain a selected repository, while `what is next` recommends
+improvements. Add command definitions in `frontend/commands.json` and matching
+localized prompt files in `backend/templates/<locale>/commands/`.
+
+`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,50 @@
+#!/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 { runNewCommand } from './commands/new-command.js';
+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('new <packageName>')
+        .description('create a new HagiTask package scaffold')
+        .option('-d, --target <path>', 'target package directory')
+        .option('--destination <path>', 'alias for --target')
+        .option('--output <path>', 'alias for --target')
+        .option('-r, --repository <repositories...>', 'repository identifier(s) to offer in the selector')
+        .action((packageName, options) => {
+        const result = runNewCommand(packageName, options);
+        if (result.error)
+            console.error(result.error);
+        process.exitCode = result.code;
+    });
+    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,aAAa,EAA0B,MAAM,2BAA2B,CAAC;AAClF,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,mBAAmB,CAAC;SAC5B,WAAW,CAAC,wCAAwC,CAAC;SACrD,MAAM,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;SACzD,MAAM,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;SACpD,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;SAC/C,MAAM,CAAC,oCAAoC,EAAE,mDAAmD,CAAC;SACjG,MAAM,CAAC,CAAC,WAAmB,EAAE,OAA0B,EAAE,EAAE;QAC1D,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IACjC,CAAC,CAAC,CAAC;IACL,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/new-command.d.ts

@@ -0,0 +1,14 @@
+export interface NewCommandOptions {
+    target?: string;
+    destination?: string;
+    output?: string;
+    repositories?: string[];
+    repository?: string[];
+}
+export interface NewCommandResult {
+    code: number;
+    packagePath?: string;
+    files?: string[];
+    error?: string;
+}
+export declare function runNewCommand(packageName: string | undefined, options?: NewCommandOptions, cwd?: string): NewCommandResult;

package/dist/commands/new-command.js

@@ -0,0 +1,78 @@
+import { existsSync, mkdirSync, readdirSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { createNewPackageFiles } from '../templates/new-package.js';
+const PACKAGE_NAME = /^[a-z0-9][a-z0-9-]*$/;
+const REPOSITORY_ID = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;
+function optionTarget(options) {
+    return options.target ?? options.destination ?? options.output;
+}
+function repositoriesFromOptions(options) {
+    const values = options.repositories ?? options.repository ?? [];
+    return values.flatMap((value) => value.split(',').map((item) => item.trim())).filter(Boolean);
+}
+function validateInput(packageName, options) {
+    if (!packageName || !PACKAGE_NAME.test(packageName)) {
+        return 'package name must match ^[a-z0-9][a-z0-9-]*$';
+    }
+    const repositories = repositoriesFromOptions(options);
+    if (repositories.some((repository) => !REPOSITORY_ID.test(repository) || repository.includes('..'))) {
+        return 'repository identifiers must be non-empty and contain only letters, numbers, ".", "_", "-", or "/"';
+    }
+    const target = optionTarget(options);
+    if (target !== undefined && (!target.trim() || target.includes('\0'))) {
+        return 'target path must be a non-empty valid path';
+    }
+    return undefined;
+}
+export function runNewCommand(packageName, options = {}, cwd = process.cwd()) {
+    const inputError = validateInput(packageName, options);
+    if (inputError)
+        return { code: 1, error: inputError };
+    const name = packageName;
+    const target = resolve(cwd, optionTarget(options) ?? name);
+    if (optionTarget(options) !== undefined && basename(target) !== name) {
+        return { code: 1, error: `target directory name must equal package name '${name}'` };
+    }
+    if (existsSync(target)) {
+        if (!statSync(target).isDirectory())
+            return { code: 1, error: `target path is not a directory: ${target}` };
+        if (readdirSync(target).length > 0)
+            return { code: 1, error: `target directory is not empty: ${target}` };
+    }
+    const files = createNewPackageFiles({
+        packageName: name,
+        repositories: repositoriesFromOptions(options),
+    });
+    const createdPaths = [];
+    const targetWasCreated = !existsSync(target);
+    try {
+        mkdirSync(target, { recursive: true });
+        for (const file of files) {
+            const filePath = join(target, file.path);
+            const parent = dirname(filePath);
+            const missingDirectories = [];
+            let current = parent;
+            while (current !== target && !existsSync(current)) {
+                missingDirectories.push(current);
+                current = dirname(current);
+            }
+            mkdirSync(parent, { recursive: true });
+            createdPaths.push(...missingDirectories);
+            writeFileSync(filePath, file.contents, { encoding: 'utf8', flag: 'wx' });
+            createdPaths.push(filePath);
+        }
+    }
+    catch (error) {
+        for (const filePath of createdPaths.reverse())
+            rmSync(filePath, { force: true, recursive: true });
+        if (targetWasCreated)
+            rmSync(target, { recursive: true, force: true });
+        return { code: 1, error: `unable to create package: ${error instanceof Error ? error.message : String(error)}` };
+    }
+    const relativeFiles = files.map((file) => file.path);
+    console.log(`Created HagiTask package at ${target}`);
+    console.log(relativeFiles.map((file) => `- ${file}`).join('\n'));
+    console.log('Next: run `hagitask validate <path>` and add commands under commands/.');
+    return { code: 0, packagePath: target, files: relativeFiles };
+}
+//# sourceMappingURL=new-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"new-command.js","sourceRoot":"","sources":["../../src/commands/new-command.ts"],"names":[],"mappings":"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"}

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: string;
+export declare const packageMetadata: {
+    readonly name: "@hagicode/hagitask";
+    readonly version: string;
+};
+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,42 @@
+import { readFileSync } from 'node:fs';
+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';
+function readPackageVersion() {
+    try {
+        const packagePath = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+        const version = JSON.parse(readFileSync(packagePath, 'utf8')).version;
+        return typeof version === 'string' ? version : '0.1.0';
+    }
+    catch {
+        return '0.1.0';
+    }
+}
+export const PACKAGE_NAME = '@hagicode/hagitask';
+export const PACKAGE_VERSION = readPackageVersion();
+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,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,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAI/E,SAAS,kBAAkB;IACzB,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,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACtE,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;AACpD,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/templates/new-package.d.ts

@@ -0,0 +1,9 @@
+export interface NewPackageTemplateContext {
+    packageName: string;
+    repositories: string[];
+}
+export interface NewPackageFile {
+    path: string;
+    contents: string;
+}
+export declare function createNewPackageFiles(context: NewPackageTemplateContext): NewPackageFile[];