@taskset/cli 2.0.0 → 3.0.2

package/CHANGELOG.md

@@ -1,14 +1,61 @@
 # @taskset/cli
 
+## 3.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @taskset/core@3.0.2
+
+## 3.0.1
+
+### Patch Changes
+
+- Generated metadata views no longer create redundant ID indexes, group timestamp
+  metadata by calendar date, and use readable filenames instead of URL-encoded
+  spaces or path separators.
+- Updated dependencies
+  - @taskset/core@3.0.1
+
+## 3.0.0
+
+### Major Changes
+
+- Remove repository config version fields and stop writing version fields to generated, cached, and snapshot metadata JSON. Config files now export a strict versionless object.
+
+  Generated metadata views now cover every supported task metadata field using field-name directories such as `assignees/`, `projects/`, `files/`, and `dueDate/`; stale generated output remains disposable and rebuildable with `taskset generate`.
+
+### Patch Changes
+
+- Updated dependencies
+  - @taskset/contracts@3.0.0
+  - @taskset/core@3.0.0
+
+## 2.1.0
+
+### Minor Changes
+
+- 042a622: Add optional task `order` metadata for user-controlled sequencing. The CLI can
+  set, clear, and sort by order; core queries and generated views sort ordered
+  tasks first, place unordered tasks after them, and use task IDs as the
+  deterministic tie breaker.
+
+### Patch Changes
+
+- Updated dependencies [042a622]
+  - @taskset/contracts@2.1.0
+  - @taskset/core@2.1.0
+
 ## 2.0.0
 
 ### Major Changes
 
 - bc302ef: Remove task metadata schema versions and use one strict versionless task file
-  format. Task frontmatter containing `schemaVersion` is now invalid and must be
-  converted by removing that field while preserving the remaining metadata and
-  Markdown body. The old `taskset migrate --to 2` command and `migrateTasks`
-  core API were removed because there is no longer a versioned migration target.
+  format. Task frontmatter containing the legacy version field is now invalid
+  and must be converted by removing that field while preserving the remaining
+  metadata and Markdown body. The old `taskset migrate --to 2` command and
+  `migrateTasks` core API were removed because there is no longer a versioned
+  migration target.
 
 ### Minor Changes
 

package/README.md

@@ -6,8 +6,8 @@ The public command-line adapter for Taskset. Full documentation is available at
 
 ```bash
 pnpm add --save-dev @taskset/cli
-pnpm exec taskset init
-pnpm exec taskset task create --title "Document the release"
+pnpm taskset init
+pnpm taskset task create --title "Document the release"
 ```
 
 The package owns argument tokenization, Zod-backed command validation, output,
@@ -24,8 +24,8 @@ queries. Repeated path values use OR, distinct filter categories use AND,
 repeated labels require every label, and planning or timestamp ranges are
 inclusive. Filters include
 `--estimate-min`/`--estimate-max`, `--effort-min`/`--effort-max`,
-`--duplicate`, and due/created/updated before/after bounds. `tasks-for-file`
-was removed.
+`--duplicate`, `--sort order`, and due/created/updated before/after bounds.
+`tasks-for-file` was removed.
 
 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
@@ -36,5 +36,5 @@ diagnostics or generation warnings to stderr.
 ```typescript
 import { defineConfig } from '@taskset/cli'
 
-export default defineConfig({ schemaVersion: 1 })
+export default defineConfig({})
 ```

package/dist/bin.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { runCli } from "./cli.js";
+import { runCli } from './cli.js';
 process.exitCode = await runCli(process.argv.slice(2));

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAiEA,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;AAoYD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAmc/F"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAiEA,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;AA8YD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAoc/F"}

package/dist/cli.js

@@ -18,7 +18,7 @@ const USAGE = `Usage:
   taskset task delete <task-id> [--remove-dependencies] [--json] [--cwd <path>]
 
 Metadata options:
-  --status --priority --owner --team --estimate --effort --risk --due-date
+  --status --priority --order --owner --team --estimate --effort --risk --due-date
   --label --assignee --reviewer --depends-on --related --duplicate
   --parent --file --directory --project --body
   Repeat array options. Update commands also accept matching --clear-* options.
@@ -57,6 +57,7 @@ const CreateValuesSchema = z.strictObject({
     title: TrimmedStringSchema,
     status: TaskStatusSchema.optional(),
     priority: TaskPrioritySchema.optional(),
+    order: z.coerce.number().finite().nonnegative().optional(),
     label: StringListSchema.optional(),
     'depends-on': TaskIdListSchema.optional(),
     file: StringListSchema.optional(),
@@ -79,6 +80,7 @@ const CreateValuesSchema = z.strictObject({
 });
 const UPDATE_CLEAR_PAIRS = [
     ['priority', 'clear-priority'],
+    ['order', 'clear-order'],
     ['label', 'clear-labels'],
     ['depends-on', 'clear-dependencies'],
     ['file', 'clear-files'],
@@ -101,6 +103,7 @@ const UpdateValuesSchema = z
     title: TrimmedStringSchema.optional(),
     status: TaskStatusSchema.optional(),
     priority: TaskPrioritySchema.optional(),
+    order: z.coerce.number().finite().nonnegative().optional(),
     label: StringListSchema.optional(),
     'depends-on': TaskIdListSchema.optional(),
     file: StringListSchema.optional(),
@@ -119,6 +122,7 @@ const UpdateValuesSchema = z
     project: StringListSchema.optional(),
     body: z.string().optional(),
     'clear-priority': z.boolean().optional(),
+    'clear-order': z.boolean().optional(),
     'clear-labels': z.boolean().optional(),
     'clear-dependencies': z.boolean().optional(),
     'clear-files': z.boolean().optional(),
@@ -196,6 +200,7 @@ const metadataOptionDefinitions = {
     file: { type: 'string', multiple: true },
     label: { type: 'string', multiple: true },
     priority: { type: 'string' },
+    order: { type: 'string' },
     status: { type: 'string' },
     title: { type: 'string' },
     owner: { type: 'string' },
@@ -278,6 +283,11 @@ function updateInputFromValues(repository, values) {
             : values.priority !== undefined
                 ? { priority: values.priority }
                 : {}),
+        ...(values['clear-order']
+            ? { order: null }
+            : values.order !== undefined
+                ? { order: values.order }
+                : {}),
         ...(values['clear-labels']
             ? { labels: [] }
             : values.label !== undefined
@@ -499,6 +509,7 @@ export async function runCli(args, context = {}) {
                 title: values.title,
                 ...(values.status ? { status: values.status } : {}),
                 ...(values.priority ? { priority: values.priority } : {}),
+                ...(values.order !== undefined ? { order: values.order } : {}),
                 ...(values.label ? { labels: values.label } : {}),
                 ...(values['depends-on'] ? { dependsOn: values['depends-on'] } : {}),
                 ...(values.file ? { files: normalizeMutationPaths(repository, values.file) } : {}),

package/dist/index.js

@@ -1,2 +1,2 @@
 export { defineConfig } from '@taskset/core';
-export { runCli } from "./cli.js";
+export { runCli } from './cli.js';

package/package.json

@@ -2,7 +2,7 @@
   "name": "@taskset/cli",
   "type": "module",
   "private": false,
-  "version": "2.0.0",
+  "version": "3.0.2",
   "description": "The scriptable command-line interface for Taskset.",
   "license": "MIT",
   "author": {
@@ -43,14 +43,14 @@
     "node": ">=24.16.0"
   },
   "dependencies": {
-    "zod": "4.4.3",
-    "@taskset/contracts": "2.0.0",
-    "@taskset/core": "2.0.0"
+    "zod": "4.5.4",
+    "@taskset/contracts": "3.0.0",
+    "@taskset/core": "3.0.2"
   },
   "devDependencies": {
-    "@types/node": "^25.9.3",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.8",
+    "@types/node": "^26.4.1",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0",
     "@taskset/configs": "0.1.1"
   },
   "scripts": {

package/src/cli.ts

@@ -49,7 +49,7 @@ const USAGE = `Usage:
   taskset task delete <task-id> [--remove-dependencies] [--json] [--cwd <path>]
 
 Metadata options:
-  --status --priority --owner --team --estimate --effort --risk --due-date
+  --status --priority --order --owner --team --estimate --effort --risk --due-date
   --label --assignee --reviewer --depends-on --related --duplicate
   --parent --file --directory --project --body
   Repeat array options. Update commands also accept matching --clear-* options.
@@ -105,6 +105,7 @@ const CreateValuesSchema = z.strictObject({
 	title: TrimmedStringSchema,
 	status: TaskStatusSchema.optional(),
 	priority: TaskPrioritySchema.optional(),
+	order: z.coerce.number().finite().nonnegative().optional(),
 	label: StringListSchema.optional(),
 	'depends-on': TaskIdListSchema.optional(),
 	file: StringListSchema.optional(),
@@ -128,6 +129,7 @@ const CreateValuesSchema = z.strictObject({
 
 const UPDATE_CLEAR_PAIRS = [
 	['priority', 'clear-priority'],
+	['order', 'clear-order'],
 	['label', 'clear-labels'],
 	['depends-on', 'clear-dependencies'],
 	['file', 'clear-files'],
@@ -151,6 +153,7 @@ const UpdateValuesSchema = z
 		title: TrimmedStringSchema.optional(),
 		status: TaskStatusSchema.optional(),
 		priority: TaskPrioritySchema.optional(),
+		order: z.coerce.number().finite().nonnegative().optional(),
 		label: StringListSchema.optional(),
 		'depends-on': TaskIdListSchema.optional(),
 		file: StringListSchema.optional(),
@@ -169,6 +172,7 @@ const UpdateValuesSchema = z
 		project: StringListSchema.optional(),
 		body: z.string().optional(),
 		'clear-priority': z.boolean().optional(),
+		'clear-order': z.boolean().optional(),
 		'clear-labels': z.boolean().optional(),
 		'clear-dependencies': z.boolean().optional(),
 		'clear-files': z.boolean().optional(),
@@ -250,6 +254,7 @@ const metadataOptionDefinitions = {
 	file: { type: 'string', multiple: true },
 	label: { type: 'string', multiple: true },
 	priority: { type: 'string' },
+	order: { type: 'string' },
 	status: { type: 'string' },
 	title: { type: 'string' },
 	owner: { type: 'string' },
@@ -371,6 +376,11 @@ function updateInputFromValues(
 			: values.priority !== undefined
 				? { priority: values.priority }
 				: {}),
+		...(values['clear-order']
+			? { order: null }
+			: values.order !== undefined
+				? { order: values.order }
+				: {}),
 		...(values['clear-labels']
 			? { labels: [] }
 			: values.label !== undefined
@@ -630,6 +640,7 @@ export async function runCli(args: readonly string[], context: CliContext = {}):
 					title: values.title,
 					...(values.status ? { status: values.status } : {}),
 					...(values.priority ? { priority: values.priority } : {}),
+					...(values.order !== undefined ? { order: values.order } : {}),
 					...(values.label ? { labels: values.label } : {}),
 					...(values['depends-on'] ? { dependsOn: values['depends-on'] } : {}),
 					...(values.file ? { files: normalizeMutationPaths(repository, values.file) } : {}),