@indigoai-us/hq-cli 5.312.1 → 5.312.2-beta.0

package/assets/scaffold/core/scripts/register-project.sh

@@ -1,262 +0,0 @@
-#!/usr/bin/env bash
-# Register one local PRD on the Work Mesh Board and record threadId/channelId
-# on the company board.json. Audit and backfill never run unless asked.
-set -euo pipefail
-
-ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
-
-die() {
-  echo "$*" >&2
-  exit 1
-}
-
-resolve_uid() {
-  local company="$1"
-  if [ -n "${HQ_COMPANY_UID:-}" ]; then
-    printf '%s\n' "$HQ_COMPANY_UID"
-    return
-  fi
-  local file="$ROOT/companies/$company/.company-uid"
-  if [ -f "$file" ]; then
-    tr -d '[:space:]' < "$file"
-    return
-  fi
-  die "no company uid for $company (set HQ_COMPANY_UID or companies/$company/.company-uid)"
-}
-
-has_board() {
-  local company="$1" project="$2" uid
-  uid="$(resolve_uid "$company")"
-  [ -f "${HOME}/.hq/work-mesh/cache/projects/${uid}/${project}.json" ]
-}
-
-story_not_done() {
-  jq -e '[.userStories[]? | select((.status // "") != "done")] | length > 0' "$1" >/dev/null
-}
-
-recent_dir() {
-  local path="$1" mtime now age
-  case "$(uname -s)" in
-    Darwin) mtime="$(stat -f %m "$path")" ;;
-    *) mtime="$(stat -c %Y "$path")" ;;
-  esac
-  now="$(date +%s)"
-  age=$((now - mtime))
-  if [ "$age" -lt $((30 * 86400)) ]; then
-    printf 'yes\n'
-  else
-    printf 'no\n'
-  fi
-}
-
-# hq mesh project ensure shipped in hq-cli 5.139.0. Probe the subcommand,
-# not the version string: a laptop can be one release behind the supply-chain
-# install guard for up to 24h.
-MIN_HQ_CLI="5.139.0"
-
-cli_has_project_ensure() {
-  hq mesh project ensure --help >/dev/null 2>&1
-}
-
-board_path() {
-  printf '%s\n' "$ROOT/companies/$1/board.json"
-}
-
-mark_pending() {
-  local company="$1" project="$2"
-  local board prd rel now title tmp
-  board="$(board_path "$company")"
-  prd="$ROOT/companies/$company/projects/$project/prd.json"
-  rel="companies/$company/projects/$project/prd.json"
-  now="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-  title="$(jq -r '.name // empty' "$prd" 2>/dev/null || true)"
-  [ -n "$title" ] || title="$project"
-  mkdir -p "$(dirname "$board")"
-  if [ ! -f "$board" ]; then
-    jq -n --arg company "$company" '{company:$company, projects:[]}' > "$board"
-  fi
-  tmp="$(mktemp)"
-  jq \
-    --arg id "$project" \
-    --arg path "$rel" \
-    --arg now "$now" \
-    --arg title "$title" \
-    '
-      .projects = (.projects // []) |
-      if any(.projects[]; .id == $id or .prd_path == $path or .mesh_project_id == $id) then
-        .projects |= map(
-          if .id == $id or .prd_path == $path or .mesh_project_id == $id then
-            . + {pending_registration:true, updated_at:$now, prd_path:(.prd_path // $path)}
-          else . end
-        )
-      else
-        .projects += [{
-          id:$id,
-          title:$title,
-          status:"prd_created",
-          scope:"company",
-          prd_path:$path,
-          pending_registration:true,
-          created_at:$now,
-          updated_at:$now
-        }]
-      end
-    ' "$board" > "$tmp"
-  mv "$tmp" "$board"
-}
-
-register_one() {
-  local company="$1" project="$2"
-  local prd="$ROOT/companies/$company/projects/$project/prd.json"
-  [ -f "$prd" ] || die "registration incomplete: missing $prd"
-  if ! cli_has_project_ensure; then
-    mark_pending "$company" "$project"
-    die "hq-cli ${MIN_HQ_CLI} or newer is required; ${company}/${project} stays local until then"
-  fi
-  local ensure_json
-  if ! ensure_json="$(hq mesh project ensure "$project" --company "$company" --stories-file "$prd" --json)"; then
-    echo "registration incomplete: hq mesh project ensure failed for $company/$project" >&2
-    exit 1
-  fi
-  local thread channel
-  thread="$(printf '%s' "$ensure_json" | jq -er '.threadId // empty')" || die "registration incomplete: ensure output missing threadId"
-  channel="$(printf '%s' "$ensure_json" | jq -er '.channelId // empty')" || die "registration incomplete: ensure output missing channelId"
-  [ -n "$thread" ] || die "registration incomplete: empty threadId"
-  [ -n "$channel" ] || die "registration incomplete: empty channelId"
-
-  local board="$ROOT/companies/$company/board.json"
-  local rel="companies/$company/projects/$project/prd.json"
-  local now title tmp
-  now="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-  title="$(jq -r '.name // empty' "$prd")"
-  [ -n "$title" ] || title="$project"
-  mkdir -p "$(dirname "$board")"
-  if [ ! -f "$board" ]; then
-    jq -n --arg company "$company" '{company:$company, projects:[]}' > "$board"
-  fi
-  tmp="$(mktemp)"
-  jq \
-    --arg id "$project" \
-    --arg path "$rel" \
-    --arg thread "$thread" \
-    --arg channel "$channel" \
-    --arg now "$now" \
-    --arg title "$title" \
-    '
-      .projects = (.projects // []) |
-      if any(.projects[]; .id == $id or .prd_path == $path or .mesh_project_id == $id) then
-        .projects |= map(
-          if .id == $id or .prd_path == $path or .mesh_project_id == $id then
-            . + {threadId:$thread, channelId:$channel, updated_at:$now, prd_path:(.prd_path // $path), mesh_project_id:$id} | del(.pending_registration)
-          else . end
-        )
-      else
-        .projects += [{
-          id:$id,
-          title:$title,
-          status:"prd_created",
-          scope:"company",
-          prd_path:$path,
-          threadId:$thread,
-          channelId:$channel,
-          mesh_project_id:$id,
-          created_at:$now,
-          updated_at:$now
-        }]
-      end
-    ' "$board" > "$tmp"
-  mv "$tmp" "$board"
-  jq -e \
-    --arg id "$project" \
-    --arg path "$rel" \
-    --arg thread "$thread" \
-    --arg channel "$channel" \
-    'any(.projects[]?; (.id == $id or .prd_path == $path or .mesh_project_id == $id) and .threadId == $thread and .channelId == $channel)' \
-    "$board" >/dev/null \
-    || die "registration incomplete: board.json entry for $project did not verify"
-  echo "registered $company/$project thread=$thread channel=$channel"
-}
-
-audit() {
-  local company="$1"
-  [ -n "$company" ] || die "usage: register-project.sh --audit <company>"
-  local dir="$ROOT/companies/$company/projects"
-  [ -d "$dir" ] || return 0
-  local prd name
-  for prd in "$dir"/*/prd.json; do
-    [ -f "$prd" ] || continue
-    name="$(basename "$(dirname "$prd")")"
-    if ! has_board "$company" "$name"; then
-      printf '%s\n' "$name"
-    fi
-  done | sort
-}
-
-backfill() {
-  local company="" only=0 yes=0
-  while [ $# -gt 0 ]; do
-    case "$1" in
-      --only-active) only=1 ;;
-      --yes) yes=1 ;;
-      --*) die "unknown flag $1" ;;
-      *) company="$1" ;;
-    esac
-    shift
-  done
-  [ -n "$company" ] || die "usage: register-project.sh --backfill <company> --only-active [--yes]"
-  [ "$only" -eq 1 ] || die "--backfill requires --only-active"
-  local dir="$ROOT/companies/$company/projects"
-  [ -d "$dir" ] || return 0
-  local prd name recent
-  local -a targets=()
-  for prd in "$dir"/*/prd.json; do
-    [ -f "$prd" ] || continue
-    name="$(basename "$(dirname "$prd")")"
-    story_not_done "$prd" || continue
-    recent="$(recent_dir "$(dirname "$prd")")"
-    [ "$recent" = "yes" ] || continue
-    targets+=("$name")
-  done
-  IFS=$'\n' targets=($(printf '%s\n' "${targets[@]+"${targets[@]}"}" | sed '/^$/d' | sort))
-  unset IFS
-  if [ "$yes" -ne 1 ]; then
-    local item
-    for item in "${targets[@]+"${targets[@]}"}"; do
-      echo "would register $company/$item"
-    done
-    return 0
-  fi
-  local item
-  for item in "${targets[@]+"${targets[@]}"}"; do
-    register_one "$company" "$item"
-  done
-}
-
-retry_pending() {
-  local company="${1:-}"
-  [ -n "$company" ] || die "usage: register-project.sh --retry-pending <company>"
-  cli_has_project_ensure || return 0
-  local board
-  board="$(board_path "$company")"
-  [ -f "$board" ] || return 0
-  local id count=0
-  while IFS= read -r id; do
-    [ -n "$id" ] || continue
-    count=$((count + 1))
-    [ "$count" -le 3 ] || break
-    ( register_one "$company" "$id" ) || true
-  done < <(jq -r '[.projects[]? | select(.pending_registration == true) | .id // empty] | .[]' "$board" 2>/dev/null || true)
-}
-
-if [ "${1:-}" = "--audit" ]; then
-  audit "${2:-}"
-elif [ "${1:-}" = "--backfill" ]; then
-  shift
-  backfill "$@"
-elif [ "${1:-}" = "--retry-pending" ]; then
-  retry_pending "${2:-}"
-elif [ $# -eq 2 ]; then
-  register_one "$1" "$2"
-else
-  die "usage: register-project.sh <company> <project> | --audit <company> | --backfill <company> --only-active [--yes] | --retry-pending <company>"
-fi

package/assets/scaffold/core/scripts/work-mesh-live-rebind.sh

@@ -1,59 +0,0 @@
-#!/usr/bin/env bash
-# hq-core: public
-# US-011 — enqueue session_end/session_start when project binding changes.
-# Usage:
-#   work-mesh-live-rebind.sh --session <sid>
-#     Read state file and rebind if project changed vs live-binding marker.
-#   work-mesh-live-rebind.sh --session <sid> \
-#     --old-company C --old-project P [--old-task T] \
-#     --company C2 --project P2 [--task T2]
-set -euo pipefail
-
-ROOT="${HQ_ROOT:-${CLAUDE_PROJECT_DIR:-}}"
-if [ -z "$ROOT" ]; then
-  ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
-fi
-export HQ_ROOT="$ROOT"
-
-# shellcheck source=lib/work-mesh-enqueue.sh
-. "$ROOT/core/scripts/lib/work-mesh-enqueue.sh"
-# shellcheck source=lib/work-mesh-live-hook.sh
-. "$ROOT/core/scripts/lib/work-mesh-live-hook.sh" 2>/dev/null || true
-# shellcheck source=lib/work-mesh-live-rebind.sh
-. "$ROOT/core/scripts/lib/work-mesh-live-rebind.sh"
-
-SID=""
-OLD_CO="" OLD_PR="" OLD_TK=""
-NEW_CO="" NEW_PR="" NEW_TK=""
-FROM_STATE=0
-
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --session|--session-id) SID="${2:-}"; shift 2 ;;
-    --old-company) OLD_CO="${2:-}"; shift 2 ;;
-    --old-project) OLD_PR="${2:-}"; shift 2 ;;
-    --old-task) OLD_TK="${2:-}"; shift 2 ;;
-    --company|--company-slug) NEW_CO="${2:-}"; shift 2 ;;
-    --project) NEW_PR="${2:-}"; shift 2 ;;
-    --task) NEW_TK="${2:-}"; shift 2 ;;
-    --from-state) FROM_STATE=1; shift ;;
-    *) shift ;;
-  esac
-done
-
-[ -n "$SID" ] || { echo "usage: work-mesh-live-rebind.sh --session <sid> ..." >&2; exit 1; }
-
-if [ "$FROM_STATE" -eq 1 ] || [ -z "$NEW_PR" ]; then
-  work_mesh_live_maybe_rebind_from_state "$SID"
-else
-  if [ -z "$OLD_PR" ]; then
-    work_mesh_live_read_binding_marker "$SID"
-    old=$REPLY
-    OLD_CO="${old%%|*}"
-    rest="${old#*|}"
-    OLD_PR="${rest%%|*}"
-    OLD_TK="${rest#*|}"
-  fi
-  work_mesh_live_rebind "$SID" "$OLD_CO" "$OLD_PR" "$OLD_TK" "$NEW_CO" "$NEW_PR" "$NEW_TK"
-fi
-exit 0

package/dist/commands/company-rename-flag.d.ts

@@ -1,4 +0,0 @@
-export declare const CLI_COMPANY_RENAME_FLAG = "cli.company-rename";
-/** Company display-name updates stay unavailable until hq-flags enables them. */
-export declare function companyRenameEnabled(): boolean;
-//# sourceMappingURL=company-rename-flag.d.ts.map

package/dist/commands/company-rename-flag.js

@@ -1,7 +0,0 @@
-import { resolveProcessFlagGate } from "../lib/flag-registry.js";
-export const CLI_COMPANY_RENAME_FLAG = "cli.company-rename";
-/** Company display-name updates stay unavailable until hq-flags enables them. */
-export function companyRenameEnabled() {
-    return resolveProcessFlagGate(CLI_COMPANY_RENAME_FLAG, { fallback: false }, () => false);
-}
-//# sourceMappingURL=company-rename-flag.js.map

package/dist/commands/company-rename.d.ts

@@ -1,4 +0,0 @@
-import { Command } from "commander";
-/** Register `hq company rename <new name>` for the selected/current company. */
-export declare function registerCompanyRenameCommand(company: Command): void;
-//# sourceMappingURL=company-rename.d.ts.map

package/dist/commands/company-rename.js

@@ -1,90 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import * as yaml from "js-yaml";
-import chalk from "chalk";
-import { resolveDefaultHqRoot } from "../utils/hq-root-resolver.js";
-import { parseUserYaml } from "../utils/user-yaml-error.js";
-import { ensureCognitoToken } from "../utils/cognito-session.js";
-import { getEntityUid, vaultApiFetch } from "../utils/vault-api.js";
-import { companyRenameEnabled } from "./company-rename-flag.js";
-function fail(message) {
-    console.error(chalk.red(message));
-    process.exit(1);
-    throw new Error(message);
-}
-function resolveManifestTarget(hqRoot, requestedSlug, companyUid) {
-    const manifestPath = path.join(hqRoot, "companies", "manifest.yaml");
-    if (!fs.existsSync(manifestPath)) {
-        throw new Error(`companies/manifest.yaml not found at ${manifestPath}`);
-    }
-    const raw = fs.readFileSync(manifestPath, "utf8");
-    const parsed = parseUserYaml(raw, manifestPath);
-    if (!parsed || !parsed.companies || typeof parsed.companies !== "object") {
-        throw new Error("companies/manifest.yaml is malformed — missing top-level .companies map");
-    }
-    const slug = requestedSlug ?? Object.entries(parsed.companies).find(([, entry]) => entry && typeof entry === "object" && entry.cloud_uid === companyUid)?.[0];
-    if (!slug) {
-        throw new Error(`No local company manifest entry is bound to ${companyUid}; run from the HQ root or pass --company <slug>.`);
-    }
-    const value = parsed.companies[slug];
-    if (!value || typeof value !== "object") {
-        throw new Error(`Company '${slug}' is not present in companies/manifest.yaml.`);
-    }
-    if (requestedSlug && value.cloud_uid !== companyUid) {
-        throw new Error(`Company '${slug}' has no matching cloud_uid in companies/manifest.yaml.`);
-    }
-    return { slug, path: manifestPath, document: parsed, entry: value };
-}
-function writeManifestName(target, name) {
-    target.entry.name = name;
-    target.document.companies[target.slug] = target.entry;
-    const mode = fs.statSync(target.path).mode;
-    const temporaryPath = `${target.path}.tmp.${process.pid}`;
-    fs.writeFileSync(temporaryPath, yaml.dump(target.document, { lineWidth: -1, noRefs: true }), { mode });
-    fs.chmodSync(temporaryPath, mode);
-    fs.renameSync(temporaryPath, target.path);
-}
-/** Register `hq company rename <new name>` for the selected/current company. */
-export function registerCompanyRenameCommand(company) {
-    company
-        .command("rename <new-name>")
-        .description("Rename a cloud-backed company display name")
-        .action(async (newName) => {
-        if (!companyRenameEnabled()) {
-            fail("Company rename is not available yet.");
-        }
-        const name = newName.trim();
-        if (!name)
-            fail("Company name cannot be empty.");
-        try {
-            const requestedSlug = company.opts().company;
-            const token = await ensureCognitoToken();
-            const companyUid = await getEntityUid(token, { companySlug: requestedSlug });
-            const hqRoot = resolveDefaultHqRoot({ onMissing: "throw" });
-            const manifestTarget = resolveManifestTarget(hqRoot, requestedSlug, companyUid);
-            const response = await vaultApiFetch({
-                token,
-                path: `/entity/${encodeURIComponent(companyUid)}`,
-                method: "PATCH",
-                body: { name },
-            });
-            if (!response.ok) {
-                if (response.status === 403) {
-                    fail("Only a company owner can rename this company.");
-                }
-                if (response.status === 404) {
-                    fail("Company not found in HQ Cloud.");
-                }
-                fail(`Could not rename company (HTTP ${response.status}).`);
-            }
-            writeManifestName(manifestTarget, name);
-            console.log(chalk.green(`Company renamed to ${name}.`));
-        }
-        catch (error) {
-            if (error instanceof Error && error.message.startsWith("process.exit"))
-                throw error;
-            fail(error instanceof Error ? error.message : String(error));
-        }
-    });
-}
-//# sourceMappingURL=company-rename.js.map

package/dist/commands/core-eval-trigger-native.d.ts

@@ -1,4 +0,0 @@
-export { checkTriggerExpressions, evaluateTrigger } from "../utils/core-eval-trigger.js";
-export declare const EVAL_TRIGGER_ASSET = "core/scripts/eval-trigger.sh";
-export declare function runEvalTriggerFast(args: readonly string[], stdin: string, _cwd: string, _root: string | undefined): Promise<number>;
-//# sourceMappingURL=core-eval-trigger-native.d.ts.map

package/dist/commands/core-eval-trigger-native.js

@@ -1,12 +0,0 @@
-/** Native implementation of core/scripts/eval-trigger.sh. */
-import { checkTriggerExpressions, evaluateTrigger } from "../utils/core-eval-trigger.js";
-export { checkTriggerExpressions, evaluateTrigger } from "../utils/core-eval-trigger.js";
-export const EVAL_TRIGGER_ASSET = "core/scripts/eval-trigger.sh";
-export async function runEvalTriggerFast(args, stdin, _cwd, _root) {
-    if (args[0] === "--check") {
-        process.stdout.write(checkTriggerExpressions(stdin));
-        return 0;
-    }
-    return evaluateTrigger(args[0] ?? "", args[1] ?? "");
-}
-//# sourceMappingURL=core-eval-trigger-native.js.map

package/dist/commands/core-migrate-policy-triggers-native.d.ts

@@ -1,21 +0,0 @@
-import * as fs from "node:fs";
-export declare const MIGRATE_POLICY_TRIGGERS_ASSET = "core/scripts/migrate-policy-triggers.sh";
-export type MigratePolicyDependencies = {
-    root: string;
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-    now: () => Date;
-    fs: typeof fs;
-    evaluatorExists?: () => boolean;
-    runFlock?: (lockFd: number, cwd: string, pathValue: string) => {
-        status: number | null;
-        error?: Error;
-    };
-};
-export declare function runMigratePolicyTriggers(args: readonly string[], deps: MigratePolicyDependencies): {
-    code: number;
-    stdout: string;
-    stderr: string;
-};
-export declare function runMigratePolicyTriggersFast(args: readonly string[], _stdin: string, cwd: string, root?: string): Promise<number>;
-//# sourceMappingURL=core-migrate-policy-triggers-native.d.ts.map