@taskset/cli 4.0.0 → 6.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +38 -0
- package/README.md +23 -20
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +538 -71
- package/docs/_meta.ts +9 -0
- package/docs/agents/_meta.ts +5 -0
- package/docs/agents/commands.md +70 -0
- package/docs/agents/index.md +99 -0
- package/docs/agents/llms.txt +28 -0
- package/docs/agents/workflows.md +50 -0
- package/docs/cli-reference.md +461 -0
- package/docs/configuration.md +63 -0
- package/docs/document-types.md +103 -0
- package/docs/getting-started.md +106 -0
- package/docs/index.md +43 -0
- package/docs/maintainers/_meta.ts +7 -0
- package/docs/maintainers/architecture/_meta.ts +5 -0
- package/docs/maintainers/architecture/decisions/0001-documentation-platform.md +44 -0
- package/docs/maintainers/architecture/decisions/0002-code-architecture.md +31 -0
- package/docs/maintainers/architecture/decisions/0003-snapshot-policy.md +31 -0
- package/docs/maintainers/architecture/decisions/_meta.ts +5 -0
- package/docs/maintainers/architecture/overview.md +111 -0
- package/docs/maintainers/architecture/synchronization.md +56 -0
- package/docs/maintainers/development/_meta.ts +6 -0
- package/docs/maintainers/development/contributing.md +58 -0
- package/docs/maintainers/development/documentation.md +52 -0
- package/docs/maintainers/development/engineering.md +59 -0
- package/docs/maintainers/development/testing.md +89 -0
- package/docs/maintainers/index.md +20 -0
- package/docs/maintainers/product/_meta.ts +3 -0
- package/docs/maintainers/product/vision.md +68 -0
- package/docs/maintainers/technology.md +55 -0
- package/docs/task-files.md +180 -0
- package/package.json +8 -6
- package/skills/taskset/SKILL.md +240 -0
- package/skills/taskset/references/changesets-examples.md +97 -0
- package/skills/taskset/references/document-modeling-examples.md +63 -0
- package/skills/taskset/references/monorepo-task-modeling.md +125 -0
- package/skills/taskset/references/task-modeling-examples.md +249 -0
- package/skills/taskset-implement/SKILL.md +240 -0
- package/skills/taskset-implement/agents/openai.yaml +4 -0
- package/skills/taskset-implement/references/architecture/client-and-server.md +69 -0
- package/skills/taskset-implement/references/architecture/documentation-and-generated.md +72 -0
- package/skills/taskset-implement/references/architecture/ownership-and-dependencies.md +108 -0
- package/skills/taskset-implement/references/architecture/product-and-source.md +81 -0
- package/skills/taskset-implement/references/architecture/storage-and-snapshots.md +45 -0
- package/skills/taskset-implement/references/architecture.md +34 -0
- package/skills/taskset-implement/references/conventions/backend-and-tooling.md +33 -0
- package/skills/taskset-implement/references/conventions/design.md +38 -0
- package/skills/taskset-implement/references/conventions/interfaces-and-ui.md +50 -0
- package/skills/taskset-implement/references/conventions/naming-and-packages.md +64 -0
- package/skills/taskset-implement/references/conventions/task-files.md +94 -0
- package/skills/taskset-implement/references/conventions/tests-and-docs.md +55 -0
- package/skills/taskset-implement/references/conventions/typescript-and-exports.md +41 -0
- package/skills/taskset-implement/references/conventions.md +40 -0
- package/skills/taskset-implement/references/release.md +135 -0
- package/skills/taskset-implement/references/workflows/dependencies-and-docs-site.md +54 -0
- package/skills/taskset-implement/references/workflows/environment-and-pnpm.md +109 -0
- package/skills/taskset-implement/references/workflows/persisted-data-and-git.md +30 -0
- package/skills/taskset-implement/references/workflows/validation.md +34 -0
- package/skills/taskset-implement/references/workflows/vitest-and-test-strategy.md +82 -0
- package/skills/taskset-implement/references/workflows.md +33 -0
- package/src/cli.ts +640 -87
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,43 @@
|
|
|
1
1
|
# @taskset/cli
|
|
2
2
|
|
|
3
|
+
## 6.0.0
|
|
4
|
+
|
|
5
|
+
### Major Changes
|
|
6
|
+
|
|
7
|
+
- Make Taskset agent-first and polyglot-friendly: discover repositories by `.taskset/`, treat `taskset.config.ts` as optional, support package-runner and global installs, and split docs for humans and agents.
|
|
8
|
+
- 89c31c3: Replace sequential and ULID entity IDs with immutable 5-6 character lowercase hex IDs.
|
|
9
|
+
|
|
10
|
+
Filenames are now `{sequence}-{slug}-{id}.md`. `taskset sync` and `task migrate-ids` migrate legacy IDs, normalize filenames, repair duplicate sequence prefixes by `createdAt`, and rewrite repository references. Default task and document list sorting uses `createdAt` so creation order remains stable. Agents and commands must cite the short `id`, not the mutable sequence prefix.
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- Updated dependencies
|
|
15
|
+
- Updated dependencies [89c31c3]
|
|
16
|
+
- @taskset/core@6.0.0
|
|
17
|
+
- @taskset/contracts@6.0.0
|
|
18
|
+
|
|
19
|
+
## 5.1.0
|
|
20
|
+
|
|
21
|
+
### Minor Changes
|
|
22
|
+
|
|
23
|
+
- Ship repository docs and skills in the @taskset/cli npm tarball.
|
|
24
|
+
|
|
25
|
+
The CLI build copies root `docs/` and `skills/` into the package so installed projects can load offline guidance from `node_modules/@taskset/cli/docs` and `node_modules/@taskset/cli/skills`.
|
|
26
|
+
|
|
27
|
+
## 5.0.0
|
|
28
|
+
|
|
29
|
+
### Major Changes
|
|
30
|
+
|
|
31
|
+
- Move disposable metadata indexes beside each entity folder and give documents task-like query and mutation commands.
|
|
32
|
+
|
|
33
|
+
Generated views now live under `.taskset/tasks/.generated/` and each document-kind `.generated/` directory instead of a global `.taskset/generated/` tree. Documents accept the same metadata, list filters, search, impact, status, update, and delete surface as tasks, with document-specific statuses. Sync refreshes data `.gitignore` patterns and removes the legacy global generated directory.
|
|
34
|
+
|
|
35
|
+
### Patch Changes
|
|
36
|
+
|
|
37
|
+
- Updated dependencies
|
|
38
|
+
- @taskset/contracts@5.0.0
|
|
39
|
+
- @taskset/core@5.0.0
|
|
40
|
+
|
|
3
41
|
## 4.0.0
|
|
4
42
|
|
|
5
43
|
### Major Changes
|
package/README.md
CHANGED
|
@@ -1,38 +1,41 @@
|
|
|
1
1
|
# @taskset/cli
|
|
2
2
|
|
|
3
|
-
The public command-line adapter for Taskset. Full documentation is
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
The public command-line adapter for Taskset, the Git-native workspace for plans, research, decisions, runbooks, and executable tasks. Full documentation is on [taskset.false.foundation](https://taskset.false.foundation/), including the [CLI reference](./docs/cli-reference.md), [document types](./docs/document-types.md), and [agent guide](./docs/agents/index.md).
|
|
4
|
+
|
|
5
|
+
The published package ships the repository `docs/` and `skills/` trees beside the CLI so agents can load offline references from `node_modules/@taskset/cli/docs` and `node_modules/@taskset/cli/skills`.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
6
8
|
|
|
7
9
|
```bash
|
|
10
|
+
npx @taskset/cli@latest init
|
|
11
|
+
pnpm dlx @taskset/cli init
|
|
8
12
|
pnpm add --save-dev @taskset/cli
|
|
9
|
-
|
|
10
|
-
|
|
13
|
+
npm install --global @taskset/cli
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
taskset document create research --title "Evaluate release options"
|
|
18
|
+
taskset task create --title "Ship the release notes" --related your_research_id_here
|
|
19
|
+
taskset document list --json
|
|
20
|
+
taskset task list --json
|
|
11
21
|
```
|
|
12
22
|
|
|
13
|
-
The package owns argument tokenization, Zod-backed command validation, output,
|
|
14
|
-
and exit-code mapping. Repository behavior is delegated to `@taskset/core`.
|
|
23
|
+
The package owns argument tokenization, Zod-backed command validation, output, and exit-code mapping. Repository behavior is delegated to `@taskset/core`.
|
|
15
24
|
|
|
16
|
-
|
|
25
|
+
## Commands
|
|
17
26
|
|
|
18
27
|
- `taskset init`, `config`, `doctor`, `generate`, and `sync`
|
|
19
28
|
- `taskset task create|list|show|update|status|delete|migrate-ids`
|
|
20
|
-
- `taskset document create|import|batch|list|show` (`doc` is an alias)
|
|
29
|
+
- `taskset document create|import|batch|list|show|update|status|delete` (`doc` is an alias)
|
|
21
30
|
- `taskset snapshot create|list|restore`
|
|
22
31
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
inclusive. Filters include
|
|
27
|
-
`--estimate-min`/`--estimate-max`, `--effort-min`/`--effort-max`,
|
|
28
|
-
`--duplicate`, `--sort order`, and due/created/updated before/after bounds.
|
|
29
|
-
`tasks-for-file` was removed.
|
|
32
|
+
`init` creates `.taskset/` for tasks, stories, flows, decisions, research, and runbooks without requiring a config file. Pass `--config` for optional `taskset.config.ts`.
|
|
33
|
+
|
|
34
|
+
Exit code `0` means success, `1` means a repository or domain failure, and `2` means invalid CLI usage. Commands reserve stdout for requested output and send diagnostics to stderr.
|
|
30
35
|
|
|
31
|
-
|
|
32
|
-
means invalid CLI usage. Commands reserve stdout for requested output and send
|
|
33
|
-
diagnostics or generation warnings to stderr.
|
|
36
|
+
## Optional config helper
|
|
34
37
|
|
|
35
|
-
`defineConfig` is re-exported for `taskset.config.ts`:
|
|
38
|
+
`defineConfig` is re-exported for optional `taskset.config.ts`:
|
|
36
39
|
|
|
37
40
|
```typescript
|
|
38
41
|
import { defineConfig } from '@taskset/cli'
|
package/dist/cli.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAuGA,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC;AA6uBD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAu5B/F"}
|