@taskless/cli 0.11.0 → 0.11.2

package/dist/schemas.js

@@ -0,0 +1,65 @@
+import { o as f } from "./verify-test-BaZPwJqC.js";
+import { o as s, a, r as n, u as l, s as e, b as t, n as c, l as r, _ as o } from "./schemas-OhdGAhu_.js";
+s({
+  astGrepSchema: n(e(), l()).describe("Official ast-grep rule JSON Schema"),
+  tasklessRequirements: s({
+    requiredFields: a(e()).describe("Fields Taskless requires beyond ast-grep defaults"),
+    rules: a(
+      s({
+        name: e(),
+        description: e()
+      })
+    )
+  }).describe("Taskless-specific validation rules"),
+  examples: a(
+    s({
+      description: e(),
+      rule: n(e(), l())
+    })
+  ).describe("Curated annotated rule examples")
+});
+const i = s({
+  valid: t(),
+  errors: a(e()).describe("Human-readable error messages")
+}), d = i.extend({
+  notice: e().optional().describe(
+    "Something true about the rule that does not make it invalid — an accepted-but-off-list `language:` spelling above all. Present only when there is something to say"
+  )
+}), u = i.extend({
+  passed: c().describe("Number of test cases that passed"),
+  failed: c().describe("Number of test cases that failed")
+}), b = s({
+  engine: r("sg").describe(
+    "The engine that owns this rule, decided by where its file lives"
+  ),
+  success: t().describe("True if all layers passed"),
+  ruleId: e(),
+  schema: d.describe(
+    "Layer 1: Zod schema validation, plus the `language:` check the vendored JSON Schema cannot express"
+  ),
+  requirements: i.describe(
+    "Layer 2: Taskless requirement checks"
+  ),
+  tests: u.describe("Layer 3: sg test execution")
+}), m = s({
+  engine: r("vale"),
+  success: t().describe("True only when both buckets are populated and both behaved"),
+  ruleId: e(),
+  fixtures: o(["both", "pass-only", "fail-only", "none"]).describe(
+    "Which fixture buckets held documents. Only 'both' can succeed: one bucket alone is half a claim"
+  ),
+  missingFailures: a(e()).describe("fail/ fixtures the rule should have flagged and did not"),
+  unexpectedFindings: a(e()).describe("pass/ fixtures the rule flagged and should not have"),
+  notice: e().optional().describe(
+    "What Vale wrote to stderr while still exiting zero — a W101 ignored-assignment warning above all. Present only when Vale said something"
+  )
+});
+s({
+  success: r(!1),
+  error: e().describe("Error message")
+});
+export {
+  m as valeVerifyOutputSchema,
+  b as verifyOutputSchema,
+  f as verifyTestOutputSchema
+};

package/dist/survey/constants.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The PostHog survey the CLI answers on the user's behalf, and the map from
+ * the payload's human keys to its question identifiers.
+ *
+ * This is the ONLY place the survey's identifiers live. The agent never sees a
+ * question UUID: it writes `verbatim`, `goal`, and so on, and `feedback send`
+ * translates. A mangled UUID would be a silently missing answer; a mangled
+ * human key is a validation error with a message.
+ *
+ * The identifiers are PostHog's. `survey shown`, `survey dismissed`, and
+ * `survey sent` are its event literals for a custom survey, `$survey_id` and
+ * `$survey_response_<question id>` are its property contract, and the CLI
+ * adds no survey-specific property of its own. Everything else on the event
+ * is the standard set the telemetry client stamps on every capture.
+ *
+ * `survey shown` means SERVED. The CLI knows it appended the invite to a
+ * recipe; it cannot know the agent put the question to a person. The funnel
+ * reads shown ≫ sent by design, and nothing here pretends otherwise.
+ *
+ * A question's id changes when its type changes in PostHog. Q3 became single
+ * choice on 2026-09-17 and took a new id; the one below is current.
+ */
+export declare const SURVEY_ID = "01a0b1a0-80fb-0000-5dc1-baa4ec44e619";
+/** The payload keys, in question order. */
+export type FeedbackKey = "verbatim" | "goal" | "completed" | "workedWell" | "needsImprovement";
+export interface SurveyQuestion {
+    key: FeedbackKey;
+    id: string;
+    question: string;
+}
+export declare const SURVEY_QUESTIONS: readonly SurveyQuestion[];
+/** The choices PostHog holds for `completed`, in its own casing. */
+export declare const COMPLETED_CHOICES: readonly ["Yes", "No", "Unknown"];
+/**
+ * The recipes that carry the invite. Used by the gate alone; the events do not
+ * name the recipe, because the survey contract has no slot for it.
+ */
+export declare const SURVEYED_TOPICS: ReadonlySet<string>;
+/**
+ * How long serving an invite holds the next one off. Ten days, because the
+ * surveyed recipes are rule generation, which is the touchiest part of the
+ * agent experience, and a long quiet gap is a gap in feedback.
+ */
+export declare const SHOWN_INTERVAL_MS: number;
+/**
+ * How long an explicit answer holds the next invite off. Twenty days for both
+ * a dismissal and a sent response: either is a terminal action the user took,
+ * and only silence earns the shorter gap.
+ */
+export declare const ANSWERED_INTERVAL_MS: number;

package/dist/types/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Stable error codes emitted by CLI commands when --json is set.
+ * Recipes reference these codes by name in their `## Errors` section,
+ * so renaming a code is a breaking change for the agent contract.
+ *
+ * Add new codes by extending the union; do not rename existing codes
+ * without a major version bump.
+ */
+export type CLIErrorCode = "AUTH_REQUIRED" | "NO_GITHUB_REMOTE" | "NOT_A_GIT_REPOSITORY" | "NO_ORIGIN_REMOTE" | "UNSUPPORTED_REMOTE_HOST" | "RULE_GENERATION_FAILED" | "RULE_UNSUPPORTED" | "RULE_NOT_FOUND" | "RULE_META_UNAVAILABLE" | "RULE_EXISTS" | "RULE_ID_AMBIGUOUS" | "INVALID_INPUT" | "NETWORK_ERROR" | "SCAN_FAILED" | "ENGINE_UNAVAILABLE" | "RECONCILE_FAILED" | "SCAFFOLD_VERSION_MISMATCH" | "SCAFFOLD_MIGRATION_REQUIRED" | "SCAFFOLD_MANIFEST_UNREADABLE" | "SCAFFOLD_CONFLICT" | "INTERNAL_ERROR";
+/**
+ * Standardized JSON error envelope written to stdout when an action
+ * command exits with an error AND `--json` was set.
+ */
+export interface CLIErrorEnvelope {
+    ok: false;
+    code: CLIErrorCode;
+    message: string;
+}
+export declare function makeErrorEnvelope(code: CLIErrorCode, message: string): CLIErrorEnvelope;
+export declare function writeJsonError(code: CLIErrorCode, message: string): void;

package/dist/util/invocation.d.ts

@@ -21,6 +21,24 @@ export declare const PROD_INVOCATION = "npx @taskless/cli";
 export declare function isProductionInvocation(): boolean;
 /** This build's invocation, whatever the target. */
 export declare function buildInvocation(): string;
+/** The token skill and command sources spell the CLI invocation with. */
+export declare const INVOCATION_PLACEHOLDER = "%(TASKLESS_CLI)s";
+/**
+ * Render {@link INVOCATION_PLACEHOLDER} in an installed skill or command body
+ * to this build's invocation.
+ *
+ * The same token the recipes use, so a reader of either source sees one
+ * spelling. It is substituted as an exact token rather than rendered through
+ * sprintf: the sources are prose with no other placeholders, and sprintf
+ * would make a literal `%` in a markdown body a render error.
+ *
+ * This replaces searching the prose for the literal `npx @taskless/cli`
+ * ({@link applyCliInvocation}), which is whitespace-sensitive: a wrapped line
+ * or a doubled space left the literal in place, and a nightly install then
+ * carried a skill telling its agent to run the release package. A token
+ * either matches exactly or a test on the source notices it is missing.
+ */
+export declare function renderInvocationPlaceholder(content: string): string;
 /**
  * Rewrite the canonical `npx @taskless/cli` invocation to the build-target
  * invocation (`__TASKLESS_CLI__`).

package/dist/verify-test-BaZPwJqC.js

@@ -0,0 +1,34 @@
+import { o as t, s as e, b as s, a, _ as r } from "./schemas-OhdGAhu_.js";
+const o = t({
+  engine: r(["sg", "vale", "runtime"]),
+  ruleId: e(),
+  ok: s(),
+  errors: a(e()).describe("Human-readable failure messages"),
+  violations: a(
+    t({
+      constraintId: e().describe(
+        "Stable id of a constraint published in `@taskless/cli/reference.json`"
+      ),
+      message: e().describe(
+        "The failure message reporting it, repeated verbatim from `errors`"
+      )
+    })
+  ).describe(
+    "The subset of `errors` a published constraint accounts for. `errors` stays complete, so this is additive: read it to map a rejection to the rationale the corpus publishes, instead of matching on message text, which changes without notice. Empty when nothing failed and when what failed is not something a published constraint describes"
+  ),
+  ran: s().optional().describe(
+    "`test` only: whether the rule's tests actually ran. Branch on this, not on `ok` alone: `ok: true` with `ran: false` is not a rule that passed"
+  ),
+  refused: e().optional().describe(
+    "`test` only: the execution policy declined to run the rule's fixtures, and why. Neither a pass nor a failure, excluded from the rules tested, and never on its own a reason for a non-zero exit"
+  ),
+  notice: e().optional().describe(
+    "Something true about the rule that does not make it a failure, reported even on a pass"
+  )
+}), i = t({
+  ok: s(),
+  rules: a(o).describe("Per-rule results")
+});
+export {
+  i as o
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskless/cli",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -8,14 +8,18 @@
     "directory": "packages/cli"
   },
   "scripts": {
-    "build": "vite build && tsc -p tsconfig.prompts.json",
-    "build:nightly": "TASKLESS_BUILD_TARGET=nightly vite build && tsc -p tsconfig.prompts.json",
+    "build": "vite build && tsc -p tsconfig.public.json",
+    "build:nightly": "TASKLESS_BUILD_TARGET=nightly vite build && tsc -p tsconfig.public.json",
     "build:self": "TASKLESS_BUILD_TARGET=self vite build",
-    "generate:api": "openapi-typescript https://app.taskless.io/cli/api/__schema -o src/generated/api.d.ts",
+    "demo:manifests": "tsx scripts/print-demo-manifests.ts",
+    "generate:api": "pnpm generate:api:schema && pnpm generate:api:types",
+    "generate:api:schema": "tsx scripts/fetch-api-schema.ts",
+    "generate:api:types": "openapi-typescript src/generated/api.schema.json -o src/generated/api.d.ts",
     "generate:ast-grep-schema": "tsx scripts/fetch-ast-grep-schema.ts",
     "generate:rule-hash-vectors": "tsx scripts/fetch-rule-hash-vectors.ts",
     "generate:vale-schema": "tsx scripts/generate-vale-schema.ts",
     "prebuild": "tsx scripts/fetch-rule-hash-vectors.ts",
+    "reference": "tsx scripts/write-reference.ts",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
@@ -28,10 +32,24 @@
     "./prompts": {
       "types": "./dist/prompts/index.d.ts",
       "import": "./dist/prompts.js"
-    }
+    },
+    "./layout": {
+      "types": "./dist/layout/index.d.ts",
+      "import": "./dist/layout.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "import": "./dist/schemas.js"
+    },
+    "./node/runtimes": {
+      "types": "./dist/node/runtimes/index.d.ts",
+      "import": "./dist/node/runtimes.js"
+    },
+    "./reference.json": "./assets/reference.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "assets/reference.json"
   ],
   "engines": {
     "node": ">=22.22.0"
@@ -51,9 +69,10 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@ast-grep/cli": "0.45.2",
+    "@ast-grep/cli": "0.45.3",
     "@types/sprintf-js": "^1.1.4",
     "openapi-typescript": "^7.13.0",
+    "prettier": "^3.8.1",
     "typescript": "^5.7.2",
     "vite": "^7.3.1",
     "vite-tsconfig-paths": "^5.1.4",
@@ -63,18 +82,18 @@
     "taskless": "./dist/index.js"
   },
   "optionalDependencies": {
-    "@ast-grep/cli-darwin-arm64": "0.45.2",
-    "@ast-grep/cli-darwin-x64": "0.45.2",
-    "@ast-grep/cli-linux-arm64-gnu": "0.45.2",
-    "@ast-grep/cli-linux-x64-gnu": "0.45.2",
-    "@ast-grep/cli-win32-arm64-msvc": "0.45.2",
-    "@ast-grep/cli-win32-ia32-msvc": "0.45.2",
-    "@ast-grep/cli-win32-x64-msvc": "0.45.2",
-    "@taskless/vale-darwin-arm64": "3.18.0-20260824195610",
-    "@taskless/vale-darwin-x64": "3.18.0-20260824195610",
-    "@taskless/vale-linux-arm64": "3.18.0-20260824195610",
-    "@taskless/vale-linux-x64": "3.18.0-20260824195610",
-    "@taskless/vale-win32-arm64": "3.18.0-20260824195610",
-    "@taskless/vale-win32-x64": "3.18.0-20260824195610"
+    "@ast-grep/cli-darwin-arm64": "0.45.3",
+    "@ast-grep/cli-darwin-x64": "0.45.3",
+    "@ast-grep/cli-linux-arm64-gnu": "0.45.3",
+    "@ast-grep/cli-linux-x64-gnu": "0.45.3",
+    "@ast-grep/cli-win32-arm64-msvc": "0.45.3",
+    "@ast-grep/cli-win32-ia32-msvc": "0.45.3",
+    "@ast-grep/cli-win32-x64-msvc": "0.45.3",
+    "@taskless/vale-darwin-arm64": "3.21.0-20260915061224",
+    "@taskless/vale-darwin-x64": "3.21.0-20260915061224",
+    "@taskless/vale-linux-arm64": "3.21.0-20260915061224",
+    "@taskless/vale-linux-x64": "3.21.0-20260915061224",
+    "@taskless/vale-win32-arm64": "3.21.0-20260915061224",
+    "@taskless/vale-win32-x64": "3.21.0-20260915061224"
   }
 }