taktcli 0.8.2__tar.gz → 0.8.3__tar.gz

{taktcli-0.8.2 → taktcli-0.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: taktcli
-Version: 0.8.2
+Version: 0.8.3
 Summary: Authorized GraphQL CLI for Takt — full GraphQL surface from the shell, stdlib-only core
 Author: Takt
 License: MIT
@@ -230,6 +230,7 @@ Every MCP tool maps to a verb:
 | `create_wiki` | `wikis create` |
 | *(none — CLI-only; GraphQL `updateWiki` / `renameWiki`)* | `wikis update <slug>` |
 | *(none — CLI-only; GraphQL `wikiRenamePreview`)* | `wikis rename-preview <slug> --new-slug S` |
+| *(none — CLI-only; GraphQL `deleteWiki` / `wikiDeletePreview`)* | `wikis delete <slug> --yes` / `--dry-run` |
 | `get_project_wiki` | `wikis get <project>` |
 | `request_upload_url_and_headers` + `confirm_upload` | `file upload <path>` (composite) |
 | `get_file_url` | `file url <id>` |
@@ -254,7 +255,7 @@ Notes:
 - The `wiki` page verbs take `--wiki SLUG` (default `$TAKT_WIKI`)
   and stream big markdown through `--content-file` / `--old-file` / `--new-file`
   (`-` = stdin).
-- The wiki-container verbs are `wikis list/create/get/update` (entity = **Wiki**). The
+- The wiki-container verbs are `wikis list/create/get/update/rename-preview/delete` (entity = **Wiki**). The
   old `workspace list/create/get` verbs are a hard error naming the replacement
   for one release — *workspace* is being reclaimed to mean the tenant, and
   nothing else.
@@ -297,6 +298,31 @@ fails, the metadata edit does not run.
 `rename-preview` runs `wikiRenamePreview` and prints the same report without
 writing anything. It is gated like the rename.
 
+### Delete a Wiki container
+
+```bash
+taktcli wikis delete knowledge --dry-run
+taktcli wikis delete knowledge --yes
+```
+
+Deleting is **permanent**: there is no trash and no undo. Without `--yes` the
+command exits `3` before sending a request; `--dry-run` runs `wikiDeletePreview`
+and prints the report without writing anything (with or without `--yes`). Both are
+gated like a slug rename: a human workspace OWNER (`FORBIDDEN` otherwise, agents
+included).
+
+`deleteWiki` removes the wiki, its pages, their embeddings and its search feedback in
+one transaction. Projects linked to it lose their wiki. Every `[[knowledge/…]]`
+mention elsewhere in the workspace (task titles and descriptions, comments, result
+labels and content, other wikis' pages, project/wiki/workspace descriptions)
+becomes plain text `knowledge/… (deleted)`. A token whose wiki allowlist named it
+loses that entry; a list left empty stays empty (confined to nothing). It prints
+`{"deleteWiki":{"slug","pages","projects","tasks","comments","results",
+"otherPages","links","unfixable"}}`: `pages` deleted, `projects` that lost their
+wiki, rows marked per surface, `links` marked, and `unfixable` (app URLs to the
+wiki, which now 404, and external config such as `WIKI_SLUG`/`TAKT_WIKI`, CLAUDE.md,
+skills and scripts).
+
 ## Output & exit codes
 
 Default output is pretty JSON of the unwrapped `.data` payload. `--compact` =

{taktcli-0.8.2 → taktcli-0.8.3}/README.md

@@ -214,6 +214,7 @@ Every MCP tool maps to a verb:
 | `create_wiki` | `wikis create` |
 | *(none — CLI-only; GraphQL `updateWiki` / `renameWiki`)* | `wikis update <slug>` |
 | *(none — CLI-only; GraphQL `wikiRenamePreview`)* | `wikis rename-preview <slug> --new-slug S` |
+| *(none — CLI-only; GraphQL `deleteWiki` / `wikiDeletePreview`)* | `wikis delete <slug> --yes` / `--dry-run` |
 | `get_project_wiki` | `wikis get <project>` |
 | `request_upload_url_and_headers` + `confirm_upload` | `file upload <path>` (composite) |
 | `get_file_url` | `file url <id>` |
@@ -238,7 +239,7 @@ Notes:
 - The `wiki` page verbs take `--wiki SLUG` (default `$TAKT_WIKI`)
   and stream big markdown through `--content-file` / `--old-file` / `--new-file`
   (`-` = stdin).
-- The wiki-container verbs are `wikis list/create/get/update` (entity = **Wiki**). The
+- The wiki-container verbs are `wikis list/create/get/update/rename-preview/delete` (entity = **Wiki**). The
   old `workspace list/create/get` verbs are a hard error naming the replacement
   for one release — *workspace* is being reclaimed to mean the tenant, and
   nothing else.
@@ -281,6 +282,31 @@ fails, the metadata edit does not run.
 `rename-preview` runs `wikiRenamePreview` and prints the same report without
 writing anything. It is gated like the rename.
 
+### Delete a Wiki container
+
+```bash
+taktcli wikis delete knowledge --dry-run
+taktcli wikis delete knowledge --yes
+```
+
+Deleting is **permanent**: there is no trash and no undo. Without `--yes` the
+command exits `3` before sending a request; `--dry-run` runs `wikiDeletePreview`
+and prints the report without writing anything (with or without `--yes`). Both are
+gated like a slug rename: a human workspace OWNER (`FORBIDDEN` otherwise, agents
+included).
+
+`deleteWiki` removes the wiki, its pages, their embeddings and its search feedback in
+one transaction. Projects linked to it lose their wiki. Every `[[knowledge/…]]`
+mention elsewhere in the workspace (task titles and descriptions, comments, result
+labels and content, other wikis' pages, project/wiki/workspace descriptions)
+becomes plain text `knowledge/… (deleted)`. A token whose wiki allowlist named it
+loses that entry; a list left empty stays empty (confined to nothing). It prints
+`{"deleteWiki":{"slug","pages","projects","tasks","comments","results",
+"otherPages","links","unfixable"}}`: `pages` deleted, `projects` that lost their
+wiki, rows marked per surface, `links` marked, and `unfixable` (app URLs to the
+wiki, which now 404, and external config such as `WIKI_SLUG`/`TAKT_WIKI`, CLAUDE.md,
+skills and scripts).
+
 ## Output & exit codes
 
 Default output is pretty JSON of the unwrapped `.data` payload. `--compact` =

{taktcli-0.8.2 → taktcli-0.8.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "taktcli"
-version = "0.8.2"
+version = "0.8.3"
 description = "Authorized GraphQL CLI for Takt — full GraphQL surface from the shell, stdlib-only core"
 readme = "README.md"
 requires-python = ">=3.12"

{taktcli-0.8.2 → taktcli-0.8.3}/taktcli/commands/wikis.py

@@ -59,6 +59,19 @@ def register(subparsers) -> None:
     add_output_args(p)
     p.set_defaults(func=rename_preview)
 
+    p = verbs.add_parser(
+        "delete",
+        help="permanently delete a Wiki and its pages (workspace OWNER); marks refs to it as (deleted)",
+    )
+    p.add_argument("slug", help="Wiki slug (explicit; does not use TAKT_WIKI)")
+    p.add_argument("--yes", action="store_true", help="confirm the permanent delete")
+    p.add_argument(
+        "--dry-run", action="store_true",
+        help="print what the delete would remove and mark, without changing anything",
+    )
+    add_output_args(p)
+    p.set_defaults(func=delete)
+
     p = verbs.add_parser("get", help="get a project's Wiki")
     p.add_argument("project")
     add_output_args(p)
@@ -129,6 +142,25 @@ def rename_preview(args) -> int:
     return run_op(args, document, {"slug": args.slug, "newSlug": args.new_slug})
 
 
+DELETE_REPORT_FIELDS = "slug pages projects tasks comments results otherPages links unfixable"
+
+
+def delete(args) -> int:
+    """Permanently delete a Wiki via ``deleteWiki`` and print its report; ``--dry-run`` previews.
+
+    Refuses (exit 3) without ``--yes`` unless ``--dry-run``: there is no undo.
+    """
+    if args.dry_run:
+        document = f"query($slug:String!){{wikiDeletePreview(slug:$slug){{{DELETE_REPORT_FIELDS}}}}}"
+        return run_op(args, document, {"slug": args.slug})
+    if not args.yes:
+        raise ConfigError(
+            f"deleting wiki '{args.slug}' is permanent: pass --yes to confirm, or --dry-run to preview"
+        )
+    document = f"mutation($slug:String!){{deleteWiki(slug:$slug){{{DELETE_REPORT_FIELDS}}}}}"
+    return run_op(args, document, {"slug": args.slug})
+
+
 def get(args) -> int:
     document = (
         "query($slug:String!){"

{taktcli-0.8.2 → taktcli-0.8.3}/taktcli/skills/takt/references/cli.md

@@ -122,5 +122,5 @@ Don't use: `claim` / `release` / `--lease` (deprecated aliases of `run` / `stop`
 | search results are ordered by date | you passed `--order-by UPDATED_AT`, or you're on `wiki list`/`wiki grep`. Check `order` in the output. |
 | does `run` lock the task? | no. Whoever dispatches decides who works it; check before starting a RUNNING task. |
 | cancel a task? | `taktcli task transition <id> cancel` |
-| a wiki container vs a page? | `wikis …` acts on whole wikis; `wiki …` on pages. `wikis update <slug> --name N` renames a wiki's display name; `--new-slug S --yes-rewrite-links` changes its slug and rewrites every link to it (OWNER only, `wikis rename-preview` first). |
+| a wiki container vs a page? | `wikis …` acts on whole wikis; `wiki …` on pages. `wikis update <slug> --name N` renames a wiki's display name; `--new-slug S --yes-rewrite-links` changes its slug and rewrites every link to it (OWNER only, `wikis rename-preview` first). `wikis delete <slug> --yes` deletes it permanently and marks links to it `(deleted)` (OWNER only, `--dry-run` first). |
 | find mentions of a task | `wiki grep "web-42" --wiki <w>` (literal; never `--regex` on `[[…]]`) |

{taktcli-0.8.2 → taktcli-0.8.3}/taktcli/skills/takt/references/plumbing.md

@@ -102,12 +102,15 @@ taktcli wikis get <project-slug>
 taktcli wikis update <slug> --name N | --description TEXT | --description-file d.md
 taktcli wikis rename-preview <slug> --new-slug S
 taktcli wikis update <slug> --new-slug S --yes-rewrite-links [--name N …]
+taktcli wikis delete <slug> --dry-run
+taktcli wikis delete <slug> --yes
 ```
 
 - `wikis create` makes a wiki; `wiki create` makes a page.
 - `wikis update` needs an explicit slug and at least one field; omitted fields stay.
 - Renaming a slug needs a human workspace OWNER, so an agent token gets `FORBIDDEN`. `--new-slug S` also needs `--yes-rewrite-links`. The rename rewrites every `[[old/…]]` mention and app URL to the wiki (`/wiki/old/…`, `/w/<ws>/wiki/old/…`) in page titles, content and summaries, task titles and descriptions, comments, result labels and content, and project, wiki and workspace descriptions of the workspace. It prints `renameWiki.report`: `pages`, `tasks`, `comments` and `results` (rows changed), `links` (occurrences rewritten) and `unfixable` (what you must update by hand, such as `WIKI_SLUG`/`TAKT_WIKI` env, CLAUDE.md, skills, scripts and bookmarks). The old slug 404s, and there is no redirect.
 - `wikis rename-preview` returns the same report without writing anything. Run it first, and update the external config it lists after the rename.
+- `wikis delete` is **permanent** (no trash, no undo) and gated like a rename: a human workspace OWNER, so an agent token gets `FORBIDDEN`. It refuses without `--yes`; `--dry-run` prints the preview instead. The wiki's pages, their embeddings and its search feedback go with it; projects linked to it lose their wiki. Every `[[slug/…]]` mention elsewhere in the workspace (task titles and descriptions, comments, results, other wikis' pages, descriptions) becomes plain `slug/… (deleted)`. It prints the report: `pages` (deleted), `projects` (slugs that lost their wiki), `tasks`, `comments`, `results`, `otherPages` (rows marked), `links` (mentions marked) and `unfixable` (app URLs to the wiki, which now 404, and external config such as `WIKI_SLUG`/`TAKT_WIKI`, CLAUDE.md, skills and scripts). A token confined to that wiki keeps working only for what else it was confined to; confined to nothing, it reads nothing.
 
 ## Defaults and versions
 

{taktcli-0.8.2 → taktcli-0.8.3}/taktcli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: taktcli
-Version: 0.8.2
+Version: 0.8.3
 Summary: Authorized GraphQL CLI for Takt — full GraphQL surface from the shell, stdlib-only core
 Author: Takt
 License: MIT
@@ -230,6 +230,7 @@ Every MCP tool maps to a verb:
 | `create_wiki` | `wikis create` |
 | *(none — CLI-only; GraphQL `updateWiki` / `renameWiki`)* | `wikis update <slug>` |
 | *(none — CLI-only; GraphQL `wikiRenamePreview`)* | `wikis rename-preview <slug> --new-slug S` |
+| *(none — CLI-only; GraphQL `deleteWiki` / `wikiDeletePreview`)* | `wikis delete <slug> --yes` / `--dry-run` |
 | `get_project_wiki` | `wikis get <project>` |
 | `request_upload_url_and_headers` + `confirm_upload` | `file upload <path>` (composite) |
 | `get_file_url` | `file url <id>` |
@@ -254,7 +255,7 @@ Notes:
 - The `wiki` page verbs take `--wiki SLUG` (default `$TAKT_WIKI`)
   and stream big markdown through `--content-file` / `--old-file` / `--new-file`
   (`-` = stdin).
-- The wiki-container verbs are `wikis list/create/get/update` (entity = **Wiki**). The
+- The wiki-container verbs are `wikis list/create/get/update/rename-preview/delete` (entity = **Wiki**). The
   old `workspace list/create/get` verbs are a hard error naming the replacement
   for one release — *workspace* is being reclaimed to mean the tenant, and
   nothing else.
@@ -297,6 +298,31 @@ fails, the metadata edit does not run.
 `rename-preview` runs `wikiRenamePreview` and prints the same report without
 writing anything. It is gated like the rename.
 
+### Delete a Wiki container
+
+```bash
+taktcli wikis delete knowledge --dry-run
+taktcli wikis delete knowledge --yes
+```
+
+Deleting is **permanent**: there is no trash and no undo. Without `--yes` the
+command exits `3` before sending a request; `--dry-run` runs `wikiDeletePreview`
+and prints the report without writing anything (with or without `--yes`). Both are
+gated like a slug rename: a human workspace OWNER (`FORBIDDEN` otherwise, agents
+included).
+
+`deleteWiki` removes the wiki, its pages, their embeddings and its search feedback in
+one transaction. Projects linked to it lose their wiki. Every `[[knowledge/…]]`
+mention elsewhere in the workspace (task titles and descriptions, comments, result
+labels and content, other wikis' pages, project/wiki/workspace descriptions)
+becomes plain text `knowledge/… (deleted)`. A token whose wiki allowlist named it
+loses that entry; a list left empty stays empty (confined to nothing). It prints
+`{"deleteWiki":{"slug","pages","projects","tasks","comments","results",
+"otherPages","links","unfixable"}}`: `pages` deleted, `projects` that lost their
+wiki, rows marked per surface, `links` marked, and `unfixable` (app URLs to the
+wiki, which now 404, and external config such as `WIKI_SLUG`/`TAKT_WIKI`, CLAUDE.md,
+skills and scripts).
+
 ## Output & exit codes
 
 Default output is pretty JSON of the unwrapped `.data` payload. `--compact` =

{taktcli-0.8.2 → taktcli-0.8.3}/tests/test_wikis.py

@@ -169,7 +169,7 @@ def test_rename_preview_requires_new_slug(monkeypatch, capsys):
 
 @pytest.mark.parametrize("error_code,message", [
     ("DUPLICATE", "Wiki with slug 'renamed' already exists"),
-    ("FORBIDDEN", "Workspace OWNER role required for wiki slug changes"),
+    ("FORBIDDEN", "Workspace OWNER role required to change a wiki's slug or delete it"),
 ])
 def test_update_server_errors_exit_one(monkeypatch, capsys, error_code, message):
     errors = [{"message": message, "extensions": {"code": error_code}}]
@@ -194,3 +194,47 @@ def test_update_output(monkeypatch, capsys, flags):
     assert not output.err
     if "--compact" in flags:
         assert len(output.out.splitlines()) == 1
+
+
+DELETE_REPORT = {
+    "slug": "kb", "pages": 4, "projects": ["api"], "tasks": 2, "comments": 1, "results": 0,
+    "otherPages": 3, "links": 9, "unfixable": ["External config ..."],
+}
+
+
+def test_delete_requires_yes(monkeypatch, capsys):
+    capture = {}
+    patch(monkeypatch, capture=capture)
+    assert main(["wikis", "delete", "kb"]) == 3
+    err = capsys.readouterr().err
+    assert "permanent" in err and "--yes" in err and "--dry-run" in err
+    assert capture == {}
+
+
+def test_delete_with_yes_calls_delete_wiki(monkeypatch, capsys):
+    code, cap = run(monkeypatch, ["wikis", "delete", "kb", "--yes"], data={"deleteWiki": DELETE_REPORT})
+    assert code == 0
+    assert cap["query"].startswith("mutation(")
+    assert "deleteWiki(slug:$slug){slug pages projects tasks comments results otherPages links unfixable}" in cap["query"]
+    assert cap["variables"] == {"slug": "kb"}
+    assert json.loads(capsys.readouterr().out) == {"deleteWiki": DELETE_REPORT}
+
+
+@pytest.mark.parametrize("flags", [["--dry-run"], ["--dry-run", "--yes"]])
+def test_delete_dry_run_only_previews(monkeypatch, capsys, flags):
+    code, cap = run(monkeypatch, ["wikis", "delete", "kb", *flags], data={"wikiDeletePreview": DELETE_REPORT})
+    assert code == 0
+    assert cap["query"].startswith("query(")
+    assert "wikiDeletePreview(slug:$slug){slug pages" in cap["query"]
+    assert "deleteWiki" not in cap["query"]
+    assert json.loads(capsys.readouterr().out) == {"wikiDeletePreview": DELETE_REPORT}
+
+
+def test_delete_server_error_exits_one(monkeypatch, capsys):
+    errors = [{"message": "Workspace OWNER role required to change a wiki's slug or delete it",
+               "extensions": {"code": "FORBIDDEN"}}]
+    monkeypatch.setattr("taktcli.commands._run.resolve_auth", lambda: (URL, TOKEN))
+    opener = make_opener({"data": None, "errors": errors}, capture={})
+    monkeypatch.setattr("taktcli.commands._run.execute", partial(execute, opener=opener))
+    assert main(["wikis", "delete", "kb", "--yes"]) == 1
+    assert json.loads(capsys.readouterr().err) == {"errors": errors}