wildcrane 0.0.0-stage → 0.11.3

package/LICENSE

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 Tao Wu
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# wildcrane
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The CLI for WildCrane. See the draft. Let agents do the rest.
+
+See the [project README](https://github.com/ai4kanban/ai4kanban#readme) for the product overview and [documentation](https://wildcrane.ai/docs) for setup and usage.
+
+## Install
+
+```bash
+npm install -g wildcrane@latest
+```
+
+Still on the old `ai4kanban` package? Run `npm uninstall -g ai4kanban` first; both install `akb`.
+
+Run `akb help` for commands and `akb guide` for workflows.

package/bin/ai4kanban.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+//
+// wildcrane — the loader. Installed as `akb` too; `npx --yes wildcrane@latest <command>` runs
+// it without installing anything.
+//
+// It does three things and nothing else: work out how the command was typed, find this
+// package's built rules, and hand the whole command line to one of the two trees in there —
+// `akb raw <move>`, or everything else.
+//
+// Why so little lives here: the desktop app carries `bin/` and `dist/` and no node_modules
+// beside them (desktop/scripts/bundle-cli.mjs), so this file must have no dependencies. The
+// commands, their options and their help are declared in cli/src/lib/cli/, which the build
+// bundles — with everything it needs — into the one file this loads.
+//
+// Node 18+, same behaviour on macOS, Linux and Windows.
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const PKG_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const PKG = JSON.parse(fs.readFileSync(path.join(PKG_DIR, 'package.json'), 'utf8'))
+const NAME = PKG.name
+const VERSION = PKG.version
+
+// How this command was reached, spelled so what it prints can be pasted straight back.
+//
+// A global install puts it on the PATH as `akb`, and every example everywhere spells it that
+// way. It is also run as a path — `node cli/bin/ai4kanban.mjs` in a source checkout, the copy
+// inside the desktop app — and printing `akb` to a reader who has none is printing a line
+// that ends in `command not found`. Whoever typed it is right here in argv, so ask that
+// rather than guessing: only the PATH spellings are `akb`, `.mjs` never is.
+//
+// Not what's on the PATH, which is a different question with a different answer: `npx` puts
+// an `akb` on the PATH of THIS process and nothing else, so the reader would still be given a
+// line their own shell can't run. That one is spotted by the cache it runs out of, and
+// answered with the same fetch pinned to this version — never `@latest`, which is how a board
+// comes to be driven by two versions of its own rules.
+//
+// AI4KANBAN_COMMAND is how the desktop app's launcher says what it was typed as. That
+// launcher is reached as `akb` on the PATH and then runs this file by its path, so argv alone
+// would report the copy inside the app — a line no reader can paste.
+const PROGRAM = (() => {
+  const named = (process.env.AI4KANBAN_COMMAND || '').trim()
+  if (named) return named
+  const entry = process.argv[1] || ''
+  if (/[\\/](_npx|dlx)[\\/]/.test(entry)) return `npx --yes ${NAME}@${VERSION}`
+  const base = path.basename(entry).toLowerCase().replace(/\.(cmd|ps1|exe)$/, '')
+  if (base === 'akb' || base === NAME) return 'akb'
+  return `node ${nearPath(entry)}`
+})()
+
+// How a path is spelled in something a person is meant to paste back.
+//
+// Relative when it is a short hop down from where the command was typed — a checkout says
+// `node cli/bin/ai4kanban.mjs`, which reads inside a sentence and is what the project's own
+// notes spell. Absolute otherwise, and absolute is the safe answer: run from `/`, a relative
+// path is the whole absolute one with its leading slash quietly removed, which runs from that
+// one folder and nowhere else and reads to everyone else like a typo.
+function nearPath(file) {
+  const near = path.relative(process.cwd(), file)
+  const shortHop = near && !near.startsWith('..') && !path.isAbsolute(near) && near.split(/[\\/]/).length <= 3
+  return shortHop ? near : file
+}
+
+function fail(msg) {
+  console.error(`ai4kanban: ${msg}`)
+  process.exit(1)
+}
+
+// The board's rules: this package's TypeScript sources built into one file by
+// scripts/build.mjs. Everything this command actually does lives in there — the bookkeeping,
+// the runs, the setup commands, what a skill folder holds — so it is the same one copy
+// whether a terminal or the UI's buttons asks.
+//
+// One path, no searching. A published tarball carries `dist/`, and a source checkout builds
+// it on `npm install` (the `prepare` script).
+async function rules() {
+  const file = path.join(PKG_DIR, 'dist', 'kanban.mjs')
+  if (!fs.existsSync(file)) {
+    fail(
+      'no built rules in this package — run `npm install` (or `npm run build`) in cli/ ' +
+        '(a published tarball carries them already, so this one is incomplete)',
+    )
+  }
+  return import(pathToFileURL(file).href)
+}
+
+// The two trees, and the one word that picks between them. `akb raw` takes over the whole
+// command line: its moves take options that collide with the rest — `create`, `archive` and
+// `reject` are words on both sides — so it is handed the line untouched, bar the shared
+// options typed before `raw`.
+async function main() {
+  const argv = process.argv.slice(2)
+  const loaded = await rules()
+  const shared = { program: PROGRAM, installHint: `\`${PROGRAM} install\`` }
+
+  const raw = loaded.rawArgv(argv)
+  if (raw) {
+    process.exitCode = await loaded.runBoard(raw, { ...shared, program: `${PROGRAM} raw` })
+    return
+  }
+
+  const { runAgent } = loaded
+  if (typeof runAgent !== 'function') {
+    fail('this copy of the board rules is too old for this command — `npm install -g wildcrane@latest`, then `akb update`')
+  }
+  process.exitCode = await runAgent(argv, shared)
+}
+
+main()