@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.
Files changed (63) hide show
  1. package/CHANGELOG.md +38 -0
  2. package/README.md +23 -20
  3. package/dist/cli.d.ts.map +1 -1
  4. package/dist/cli.js +538 -71
  5. package/docs/_meta.ts +9 -0
  6. package/docs/agents/_meta.ts +5 -0
  7. package/docs/agents/commands.md +70 -0
  8. package/docs/agents/index.md +99 -0
  9. package/docs/agents/llms.txt +28 -0
  10. package/docs/agents/workflows.md +50 -0
  11. package/docs/cli-reference.md +461 -0
  12. package/docs/configuration.md +63 -0
  13. package/docs/document-types.md +103 -0
  14. package/docs/getting-started.md +106 -0
  15. package/docs/index.md +43 -0
  16. package/docs/maintainers/_meta.ts +7 -0
  17. package/docs/maintainers/architecture/_meta.ts +5 -0
  18. package/docs/maintainers/architecture/decisions/0001-documentation-platform.md +44 -0
  19. package/docs/maintainers/architecture/decisions/0002-code-architecture.md +31 -0
  20. package/docs/maintainers/architecture/decisions/0003-snapshot-policy.md +31 -0
  21. package/docs/maintainers/architecture/decisions/_meta.ts +5 -0
  22. package/docs/maintainers/architecture/overview.md +111 -0
  23. package/docs/maintainers/architecture/synchronization.md +56 -0
  24. package/docs/maintainers/development/_meta.ts +6 -0
  25. package/docs/maintainers/development/contributing.md +58 -0
  26. package/docs/maintainers/development/documentation.md +52 -0
  27. package/docs/maintainers/development/engineering.md +59 -0
  28. package/docs/maintainers/development/testing.md +89 -0
  29. package/docs/maintainers/index.md +20 -0
  30. package/docs/maintainers/product/_meta.ts +3 -0
  31. package/docs/maintainers/product/vision.md +68 -0
  32. package/docs/maintainers/technology.md +55 -0
  33. package/docs/task-files.md +180 -0
  34. package/package.json +8 -6
  35. package/skills/taskset/SKILL.md +240 -0
  36. package/skills/taskset/references/changesets-examples.md +97 -0
  37. package/skills/taskset/references/document-modeling-examples.md +63 -0
  38. package/skills/taskset/references/monorepo-task-modeling.md +125 -0
  39. package/skills/taskset/references/task-modeling-examples.md +249 -0
  40. package/skills/taskset-implement/SKILL.md +240 -0
  41. package/skills/taskset-implement/agents/openai.yaml +4 -0
  42. package/skills/taskset-implement/references/architecture/client-and-server.md +69 -0
  43. package/skills/taskset-implement/references/architecture/documentation-and-generated.md +72 -0
  44. package/skills/taskset-implement/references/architecture/ownership-and-dependencies.md +108 -0
  45. package/skills/taskset-implement/references/architecture/product-and-source.md +81 -0
  46. package/skills/taskset-implement/references/architecture/storage-and-snapshots.md +45 -0
  47. package/skills/taskset-implement/references/architecture.md +34 -0
  48. package/skills/taskset-implement/references/conventions/backend-and-tooling.md +33 -0
  49. package/skills/taskset-implement/references/conventions/design.md +38 -0
  50. package/skills/taskset-implement/references/conventions/interfaces-and-ui.md +50 -0
  51. package/skills/taskset-implement/references/conventions/naming-and-packages.md +64 -0
  52. package/skills/taskset-implement/references/conventions/task-files.md +94 -0
  53. package/skills/taskset-implement/references/conventions/tests-and-docs.md +55 -0
  54. package/skills/taskset-implement/references/conventions/typescript-and-exports.md +41 -0
  55. package/skills/taskset-implement/references/conventions.md +40 -0
  56. package/skills/taskset-implement/references/release.md +135 -0
  57. package/skills/taskset-implement/references/workflows/dependencies-and-docs-site.md +54 -0
  58. package/skills/taskset-implement/references/workflows/environment-and-pnpm.md +109 -0
  59. package/skills/taskset-implement/references/workflows/persisted-data-and-git.md +30 -0
  60. package/skills/taskset-implement/references/workflows/validation.md +34 -0
  61. package/skills/taskset-implement/references/workflows/vitest-and-test-strategy.md +82 -0
  62. package/skills/taskset-implement/references/workflows.md +33 -0
  63. 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 available at
4
- [taskset.false.foundation](https://taskset.false.foundation/), including the
5
- [complete CLI reference](../../docs/cli-reference.md).
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
- pnpm taskset init
10
- pnpm taskset task create --title "Document the release"
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
- Supported command groups:
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
- Use `task list --file <path> --impact` for direct and transitive code-impact
24
- queries. Repeated path values use OR, distinct filter categories use AND,
25
- repeated labels require every label, and planning or timestamp ranges are
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
- Exit code `0` means success, `1` means a repository or domain failure, and `2`
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":"AAuFA,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;AAycD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAkqB/F"}
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"}