@intentius/chant 0.124.45 → 0.124.48

package/dist/workspace/search-contract.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The `search` document of the read contract (#4374, ws-017): what
+ * `chant search --json` and `chant workspace search` print, described by
+ * `search.schema.json` beside this file.
+ *
+ * Both forms print one document. `chant search` answers over one project, and
+ * `chant workspace search` runs that same command in every member, under the
+ * member's own chant (ws-021), and composes the answers with the `<member>/<id>`
+ * ids `chant workspace graph` gives the same nodes (`search-cli.ts`).
+ *
+ * This module holds the constants both forms share and imports nothing heavy,
+ * since `cli/handlers/search.ts` loads it on every `--json` run.
+ */
+/** The version of the `search` document this chant writes. */
+export declare const SEARCH_CONTRACT_VERSION = 1;
+/** `$id` of the JSON Schema for the document, shipped beside this file. */
+export declare const SEARCH_OUTPUT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/search/v1/search.schema.json";
+/**
+ * Why `chant search` printed no answer. A member's own refusal under
+ * `chant workspace search` carries the same code as its reason.
+ */
+export declare const SEARCH_ERROR_CODES: readonly ["query-invalid", "usage-invalid", "environment-unknown", "snapshot-unavailable", "build-failed"];
+export type SearchErrorCode = (typeof SEARCH_ERROR_CODES)[number];
+/**
+ * Why `chant workspace search` printed no answer: the declaration's codes and
+ * `--at`'s, the two times given together, and a query or usage refused before
+ * any member ran.
+ */
+export declare const WORKSPACE_SEARCH_ERROR_CODES: readonly ["declaration-missing", "declaration-ambiguous", "declaration-unparseable", "declaration-invalid", "placement-invalid", "reader-too-old", "root-chant-required", "not-a-git-repository", "revision-unknown", "live-at-revision", "snapshot-at-revision", "query-invalid", "usage-invalid"];
+export type WorkspaceSearchErrorCode = (typeof WORKSPACE_SEARCH_ERROR_CODES)[number];
+/** Every `error.code` a `search` document can carry, in either form. */
+export declare const SEARCH_DOCUMENT_ERROR_CODES: ("agent-unknown" | "amend-id-immutable" | "amend-supersede-instead" | "answer-field-unsupported" | "answer-in-steward-turn" | "answer-never-over-mcp" | "answer-not-answered" | "answer-not-candidate" | "answer-point-changed" | "answer-point-unknown" | "answer-points-unreadable" | "asset-drift" | "asset-missing" | "asset-stale" | "box-capability-unbrokered" | "box-credential-declared" | "box-fountain-callback-undeclared" | "box-intent-unconstrained" | "box-intent-unknown" | "box-isolation-collision" | "box-isolation-literal" | "box-none" | "box-several" | "build-failed" | "capability-not-derivable" | "change-out-of-scope" | "change-uncovered" | "ci-branch-route-differs" | "ci-branch-unknown" | "ci-green-undeclared" | "ci-workflow-apply-in-green" | "ci-workflow-green-undeclared" | "ci-workflow-no-components" | "ci-workflow-no-environments" | "ci-workflow-no-pre-merge" | "ci-workflow-pipeline-differs" | "ci-workflow-pipeline-missing" | "ci-workflow-publish-missing" | "ci-workflow-ungated-env" | "command-failed" | "commit-unlinked" | "commit-wrongly-linked" | "composites-no-chant-member" | "composites-no-component" | "composites-none-declared" | "declaration-ambiguous" | "declaration-invalid" | "declaration-missing" | "declaration-unparseable" | "diagram-render-drift" | "diagram-render-missing" | "diagram-source-missing" | "dir-missing" | "envelope-invalid" | "envelope-unreadable" | "envelope-untrusted" | "environment-invalid" | "environment-unknown" | "environments-component-undeclared" | "environments-ledger-undeclared" | "environments-ledger-unreadable" | "environments-none-declared" | "evidence-payload-type" | "evidence-runner-mismatch" | "evidence-statement-invalid" | "executor-config-unreadable" | "executor-none-declared" | "factory-box-missing" | "factory-member-unknown" | "filter-invalid" | "flag-stale" | "flag-work-unknown" | "gates-ledger-unreadable" | "gates-no-gate-ledger" | "gates-no-ledger" | "intent-artifact-unpinned" | "intent-commit-bare" | "intent-commit-join-conflict" | "intent-commit-undecided" | "intent-constraint-coarse" | "intent-constraint-lost" | "intent-decision-contested" | "intent-decision-provisional" | "intent-decision-superseded-live" | "intent-decision-unimplemented" | "intent-evidence-unpinned" | "intent-history-shallow" | "intent-pin-drifted" | "intent-pin-missing" | "intent-pin-stale" | "intent-plugin-failed" | "intent-record-unknown" | "intent-region-invalid" | "intent-region-unconstrained" | "intent-symbol-ambiguous" | "intent-symbol-unknown" | "intent-symbol-unsupported" | "intent-trailer-unverified" | "intent-why-no-decision" | "intent-why-no-run" | "intent-why-run-ambiguous" | "intent-why-uncommitted" | "intent-work-blocked" | "intent-work-open-decided-code" | "ir-version-unsupported" | "kind-invalid" | "kind-not-run" | "kind-probe-failed" | "kind-unreadable" | "lease-held" | "lease-not-held" | "lease-push-rejected" | "lease-race" | "lease-token-mismatch" | "ledger-malformed" | "ledger-unreadable" | "lexicon-has-no-mapping" | "lexicon-not-loaded" | "listing-box-missing" | "listing-cover-invalid" | "listing-member-unknown" | "live-at-revision" | "location-missing" | "lock-invalid" | "manual-step-open" | "member-chant-too-old" | "member-exists" | "member-unknown" | "no-matches" | "not-a-git-repository" | "output-unreadable" | "patch-path-invalid" | "placement-invalid" | "point-candidates-invalid" | "point-decider-failed" | "point-inputs-invalid" | "point-unknown" | "points-invalid" | "points-undeclared" | "principal-unidentified" | "publish-answer-invalid" | "publish-failed" | "publish-member-unknown" | "publish-none" | "publish-refused" | "publish-unrecorded" | "query-invalid" | "quorum-not-met" | "ratify-quorum-not-met" | "reader-too-old" | "record-closed" | "record-conflict" | "record-id-duplicate" | "record-id-taken" | "record-id-unallocatable" | "record-no-evidence" | "record-not-found" | "record-path-unmatched" | "record-ratified-below-quorum" | "record-remediates-not-closed" | "record-remediates-unknown" | "record-schema-invalid" | "record-seal-mismatch" | "record-sign-failed" | "record-state-not-initial" | "record-supersedes-conflict" | "record-supersedes-pending" | "record-supersedes-unknown" | "record-unattested" | "record-unparseable" | "review-agent" | "review-decider" | "review-duplicate" | "review-note-required" | "review-older-digest" | "review-sign-failed" | "review-unattested" | "review-undigested" | "review-unsupported" | "revision-unknown" | "root-chant-required" | "rotation-first-version" | "rotation-invalid" | "rotation-missing" | "rotation-previous-mismatch" | "rotation-threshold-not-met" | "rotation-threshold-unsatisfiable" | "rotation-unparseable" | "rotation-version-skew" | "run-ended" | "run-exists" | "run-not-ended" | "run-statement-invalid" | "run-statement-mismatch" | "run-statement-signer-mismatch" | "run-unknown" | "runner-exists" | "runner-key-invalid" | "runner-key-is-signer" | "runner-key-unlisted" | "runner-unknown" | "runs-ledger-malformed" | "runs-no-ledger" | "runtimes-config-unreadable" | "runtimes-lexicon-unreadable" | "schema-id-mismatch" | "schema-invalid" | "schema-unreadable" | "seal-missing" | "seal-signature-invalid" | "seal-signer-unlisted" | "seal-unverifiable" | "security-attribution-any" | "security-component-no-sbom" | "security-component-no-verify" | "security-gate-unsigned" | "security-publish-allows-unsigned" | "security-publish-no-provenance" | "security-release-gate-missing" | "security-review-not-required" | "security-runner-start-no-key" | "security-runner-start-no-role" | "security-runner-untrusted" | "security-sbom-disabled" | "security-sbom-unsourced" | "security-signed-since-unset" | "security-signers-missing" | "security-tick-no-key" | "security-trust-unreadable" | "session-not-open" | "session-seal-mismatch" | "session-unknown" | "session-verdict-unknown-record" | "signers-file-missing" | "signers-removed" | "since-rev-unknown" | "since-session-open" | "since-session-unknown" | "snapshot-at-revision" | "snapshot-unavailable" | "source-harvest-not-proposed" | "source-transcript-drift" | "squash-unfollowed" | "steward-runs-unreadable" | "stewards-conflict" | "stewards-unreadable" | "table-unknown" | "trust-config-invalid" | "trust-conflict" | "trust-policy-unreadable" | "unknown-kind" | "usage-invalid" | "wip-branch-other" | "wip-no-branch" | "wip-none" | "wip-policy-none" | "wip-race" | "wip-remote-unknown" | "wip-snapshot-unknown" | "work-acceptance-self-verified" | "work-acceptance-unmet" | "work-closed-without-date" | "work-contract-undecided" | "work-contract-unknown" | "work-criterion-unknown" | "work-done-gap-open" | "work-done-unpinned" | "work-evidence-ops-mismatch" | "work-evidence-ops-missing" | "work-evidence-ops-unfinished" | "work-implements-undecided" | "work-implements-unknown" | "work-item-closed" | "work-item-unknown" | "work-kind-ambiguous" | "work-kind-missing" | "work-needs-cycle" | "work-needs-unknown" | "work-tier-unknown" | "write-input-invalid" | "write-lock-not-held" | "write-lock-timeout" | "write-scope-class-unknown" | "write-scope-kind" | "write-scope-member" | "write-scope-protected" | "write-usage-invalid")[];
+/**
+ * Why a member of `chant workspace search` has no answer. A member that ran
+ * and refused carries its own {@link SEARCH_ERROR_CODES} code; the rest are
+ * the per-member codes `workspace graph` uses, and `member-chant-too-old`.
+ */
+export declare const SEARCH_MEMBER_REASON_CODES: readonly ["kind-not-run", "dir-missing", "unknown-kind", "kind-probe-failed", "command-failed", "output-unreadable", "member-chant-too-old", "query-invalid", "usage-invalid", "environment-unknown", "snapshot-unavailable", "build-failed"];
+export type SearchMemberReasonCode = (typeof SEARCH_MEMBER_REASON_CODES)[number];
+/** The head every `search` document opens with. */
+export interface SearchHead {
+    $schema: typeof SEARCH_OUTPUT_SCHEMA_ID;
+    contract: typeof SEARCH_CONTRACT_VERSION;
+    /** The chant that wrote the document. */
+    chant: string;
+}
+/** A refusal: no answer, exit 1. `hint` is the line stderr prints after the error, when there is one. */
+export interface SearchFailure extends SearchHead {
+    query: string;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+}
+//# sourceMappingURL=search-contract.d.ts.map

package/dist/workspace/search-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-contract.d.ts","sourceRoot":"","sources":["../../src/workspace/search-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,8EAA8E,CAAC;AAEnH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,4GAWW,CAAC;AAC3C,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,qSAcC,CAAC;AAC3C,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAErF,wEAAwE;AACxE,eAAO,MAAM,2BAA2B,kgOAAqF,CAAC;AAE9H;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,+OASG,CAAC;AAC3C,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,uBAAuB,CAAC;IACxC,QAAQ,EAAE,OAAO,uBAAuB,CAAC;IACzC,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yGAAyG;AACzG,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD"}

package/dist/workspace/search-contract.js

@@ -0,0 +1,70 @@
+/**
+ * The `search` document of the read contract (#4374, ws-017): what
+ * `chant search --json` and `chant workspace search` print, described by
+ * `search.schema.json` beside this file.
+ *
+ * Both forms print one document. `chant search` answers over one project, and
+ * `chant workspace search` runs that same command in every member, under the
+ * member's own chant (ws-021), and composes the answers with the `<member>/<id>`
+ * ids `chant workspace graph` gives the same nodes (`search-cli.ts`).
+ *
+ * This module holds the constants both forms share and imports nothing heavy,
+ * since `cli/handlers/search.ts` loads it on every `--json` run.
+ */
+/** The version of the `search` document this chant writes. */
+export const SEARCH_CONTRACT_VERSION = 1;
+/** `$id` of the JSON Schema for the document, shipped beside this file. */
+export const SEARCH_OUTPUT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/search/v1/search.schema.json";
+/**
+ * Why `chant search` printed no answer. A member's own refusal under
+ * `chant workspace search` carries the same code as its reason.
+ */
+export const SEARCH_ERROR_CODES = [
+    /** No query, a term the grammar refuses, or a --count-by that is not a grouping. */
+    "query-invalid",
+    /** A flag that needs another, or two that exclude each other. */
+    "usage-invalid",
+    /** --env names an environment the project's config does not declare. */
+    "environment-unknown",
+    /** --snapshot (or plain search's --at) names nothing replay can answer from. */
+    "snapshot-unavailable",
+    /** The build, or a build root, failed: the graph would be incomplete. */
+    "build-failed",
+];
+/**
+ * Why `chant workspace search` printed no answer: the declaration's codes and
+ * `--at`'s, the two times given together, and a query or usage refused before
+ * any member ran.
+ */
+export const WORKSPACE_SEARCH_ERROR_CODES = [
+    "declaration-missing",
+    "declaration-ambiguous",
+    "declaration-unparseable",
+    "declaration-invalid",
+    "placement-invalid",
+    "reader-too-old",
+    "root-chant-required",
+    "not-a-git-repository",
+    "revision-unknown",
+    "live-at-revision",
+    "snapshot-at-revision",
+    "query-invalid",
+    "usage-invalid",
+];
+/** Every `error.code` a `search` document can carry, in either form. */
+export const SEARCH_DOCUMENT_ERROR_CODES = [...new Set([...WORKSPACE_SEARCH_ERROR_CODES, ...SEARCH_ERROR_CODES])];
+/**
+ * Why a member of `chant workspace search` has no answer. A member that ran
+ * and refused carries its own {@link SEARCH_ERROR_CODES} code; the rest are
+ * the per-member codes `workspace graph` uses, and `member-chant-too-old`.
+ */
+export const SEARCH_MEMBER_REASON_CODES = [
+    "kind-not-run",
+    "dir-missing",
+    "unknown-kind",
+    "kind-probe-failed",
+    "command-failed",
+    "output-unreadable",
+    "member-chant-too-old",
+    ...SEARCH_ERROR_CODES,
+];