@amityco/social-plus-vise 0.4.0

package/LICENSE

@@ -0,0 +1,51 @@
+Copyright (c) 2026 AmityCo, Ltd. All rights reserved.
+
+This software, including its source code, binaries, rule sets, and
+documentation (the "Software"), is the proprietary and confidential
+property of AmityCo, Ltd.
+
+PERMITTED USE
+
+You may install and use this Software solely for the purpose of
+integrating the social.plus SDK into your own applications, subject to
+your agreement with AmityCo, Ltd. covering use of the social.plus
+platform. Internal use, evaluation, and integration testing within
+your organisation are permitted.
+
+RESTRICTIONS
+
+Without prior written consent from AmityCo, Ltd. you may not:
+
+  1. Redistribute, sublicense, sell, lease, rent, or otherwise transfer
+     this Software, in whole or in part, to any third party.
+
+  2. Fork, modify, or create derivative works of the Software for
+     redistribution or for use outside your own social.plus integration.
+
+  3. Use the Software to provide services to third parties (including
+     consulting, hosted services, or system integration services) unless
+     authorised under a separate partner or reseller agreement with
+     AmityCo, Ltd.
+
+  4. Remove, alter, or obscure any copyright, trademark, or attribution
+     notices in the Software.
+
+  5. Reverse engineer or attempt to derive the source of any compiled
+     portion of the Software except as expressly permitted by applicable
+     law.
+
+The rule definitions, attestation schema, and compliance contract
+shipped in this Software (the "social.plus integration compliance
+contract") are AmityCo, Ltd.'s intellectual property. Customers own
+the attestations they record under sp-foundry/ in their own
+repositories.
+
+WARRANTY DISCLAIMER
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+IN NO EVENT SHALL AMITYCO, LTD. BE LIABLE FOR ANY CLAIM, DAMAGES, OR
+OTHER LIABILITY ARISING FROM USE OF THE SOFTWARE.
+
+Contact: legal@amity.co

package/README.md

@@ -0,0 +1,92 @@
+# Vise Skill and CLI
+
+This package provides deterministic local tooling for social.plus SDK integration assistance.
+
+The bundled skill is the AI workflow layer. It tells host agents how to move from user intent to inspect, plan, docs grounding, edits, validation, and sensor runs.
+
+The CLI is the deterministic execution layer. It can inspect repositories, detect design/theme signals, search hosted docs, plan harness guides/sensors, produce grounded integration plans with structured intake questions, validate setup patterns, and run detected project sensors.
+
+Vise is shipped locally because SDK implementation quality depends on both hosted social.plus docs and the customer's local project context. Local execution lets Vise inspect manifests, app surfaces, design tokens, lifecycle code, and constrained command sensors while keeping source code on the customer's machine.
+
+The stdio MCP server is an optional compatibility adapter over the same CLI-backed operations for MCP-capable tools. It is not the primary workflow layer.
+
+Frequent customer paths have dedicated guardrails:
+
+- feed and post creation: concrete feed target, no invented communityId/targetId/feedId, no inline API keys
+- secrets: never request API keys or credentials in chat; create env/config placeholders and have the user fill real values locally
+- notification setup: platform credentials, token source, registration after login, unregister on logout/user switch
+- Live Objects/Collections: object vs collection, observed domain, lifecycle owner, loading/error states, cleanup
+- monorepos: detected app surfaces can be selected with `surfacePath`
+
+`run_sensors` is constrained to detected project commands. It does not accept arbitrary shell input.
+
+## Commands
+
+Install Vise globally:
+
+```sh
+npm install -g @amityco/social-plus-vise
+vise doctor
+```
+
+Local development:
+
+```sh
+npm install
+npm run build
+npm start
+```
+
+CLI:
+
+```sh
+vise doctor
+vise install-skill --target codex
+vise install-skill --target claude
+vise install-skill --target claude-project .
+vise install-skill --target agents .
+vise install-skill --target cursor .
+vise install-skill --target vscode .
+vise install-skill --target copilot .
+vise print-skill
+vise search-docs "create post"
+vise get-doc-page social-plus-sdk/social/content-management/posts/creation/text-post
+vise inspect
+vise plan-harness --request "Add a social feed"
+vise plan --request "Add a social feed"
+vise init --request "Add a social feed"
+vise check
+vise sync
+vise attest --rule typescript.client.region --confidence high --signer host-agent --evidence-file evidence.json --rationale "..."
+vise explain typescript.client.region
+vise status
+vise engagement init --tier pro --customer-id acme --scope add-feed,setup-push
+vise engagement show
+vise validate
+vise run-sensors --dry-run
+vise mcp
+```
+
+Bundled skill guidance ships in `skills/social-plus-vise/SKILL.md` for coding tools that support Agent Skills or instruction-pack installation. Use `vise install-skill --target codex`, `vise install-skill --target claude`, `vise install-skill --target claude-project .`, `vise install-skill --target agents .`, `vise install-skill --target cursor .`, `vise install-skill --target vscode .`, `vise install-skill --target copilot .`, or `vise print-skill`. The Cursor target installs native project skills under `.cursor/skills`; the VS Code and Copilot targets install native project skills under `.github/skills`; `--target cursor-rules` remains available for Cursor project-rule fallback installs.
+
+Full local validation:
+
+```sh
+npm run validate
+```
+
+Product-oriented Vise improvement discovery:
+
+```sh
+npm run test:improvements
+```
+
+## Docs Source
+
+By default, docs are read from:
+
+```text
+https://learn.social.plus/llms-full.txt
+```
+
+Maintainers can set `SOCIAL_PLUS_DOCS_ROOT` to test against a local `social-plus-docs` checkout.