create-snipara 2.0.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -3
- package/dist/index.js +23 -2
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -15,9 +15,14 @@ creates or reuses auth, writes Hosted MCP config, and prepares the local project
|
|
|
15
15
|
so an LLM client can use Snipara context and reviewed memory. Install once with
|
|
16
16
|
`create-snipara`; continue every session with `snipara-companion`.
|
|
17
17
|
|
|
18
|
+
Use it when the goal is outcome-first agent work: the user asks for judgment,
|
|
19
|
+
implementation, release, or verification, and the agent handles Snipara context,
|
|
20
|
+
workflow state, package checks, Git operations, deployment, and smoke checks
|
|
21
|
+
behind the scenes.
|
|
22
|
+
|
|
18
23
|
Use it for:
|
|
19
24
|
|
|
20
|
-
- Hosted MCP onboarding for Claude Code, Cursor, Windsurf, Codex, Gemini, Mistral, VS Code/Copilot, Continue, ChatGPT Desktop, and similar clients
|
|
25
|
+
- Hosted MCP onboarding for Claude Code, Cursor, Windsurf, Codex, Gemini, Mistral, VS Code/Copilot, Continue, ChatGPT Desktop, Orca-style MCP clients, LM Studio-backed local stacks, and similar clients
|
|
21
26
|
- free account signup with reviewed Context + Memory
|
|
22
27
|
- local project wiring, `doctor`, `repair`, and `upgrade`
|
|
23
28
|
- local source activation without GitHub, plus optional GitHub repository sync and PR Answer Packs approval when the current folder is a GitHub repo
|
|
@@ -34,7 +39,7 @@ flowchart LR
|
|
|
34
39
|
CLI --> Auth["Snipara auth and project key"]
|
|
35
40
|
CLI --> MCP["Hosted MCP config"]
|
|
36
41
|
CLI --> Templates["AGENTS.md, CLAUDE.md, Cursor, Codex, MCP references"]
|
|
37
|
-
MCP --> Agents["Claude Code, Cursor, Codex, Gemini, Mistral, VS Code, ChatGPT"]
|
|
42
|
+
MCP --> Agents["Claude Code, Cursor, Codex, Gemini, Mistral, VS Code, ChatGPT, Orca, LM Studio stacks"]
|
|
38
43
|
Templates --> Agents
|
|
39
44
|
Agents --> Context["Snipara context and memory"]
|
|
40
45
|
```
|
|
@@ -77,7 +82,7 @@ Free onboarding is now **Context + Memory**, not Context-only:
|
|
|
77
82
|
|
|
78
83
|
- Context Free: three projects and 1,000 context queries/month
|
|
79
84
|
- Memory Free: reviewed hosted memories for continuity across sessions
|
|
80
|
-
- Hosted MCP: direct connection for Claude Code, Cursor, Windsurf, Codex, Gemini, Mistral, VS Code/Copilot, Continue, ChatGPT Desktop, and other MCP clients
|
|
85
|
+
- Hosted MCP: direct connection for Claude Code, Cursor, Windsurf, Codex, Gemini, Mistral, VS Code/Copilot, Continue, ChatGPT Desktop, Orca-style MCP clients, LM Studio-backed local stacks, and other MCP clients
|
|
81
86
|
|
|
82
87
|
The CLI opens a browser device-flow login when the user does not already have a key, auto-provisions the free Context + Memory account when needed, then writes the returned API key into the local MCP config.
|
|
83
88
|
|
package/dist/index.js
CHANGED
|
@@ -13,7 +13,7 @@ import { homedir } from "os";
|
|
|
13
13
|
// package.json
|
|
14
14
|
var package_default = {
|
|
15
15
|
name: "create-snipara",
|
|
16
|
-
version: "2.0.
|
|
16
|
+
version: "2.0.1",
|
|
17
17
|
description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
|
|
18
18
|
main: "dist/index.js",
|
|
19
19
|
type: "module",
|
|
@@ -48,6 +48,8 @@ var package_default = {
|
|
|
48
48
|
"windsurf",
|
|
49
49
|
"gemini",
|
|
50
50
|
"mistral",
|
|
51
|
+
"orca",
|
|
52
|
+
"lm-studio",
|
|
51
53
|
"vscode",
|
|
52
54
|
"continue",
|
|
53
55
|
"claude-desktop"
|
|
@@ -101,6 +103,17 @@ var SANDBOX_COMMAND_NAME = "snipara-sandbox";
|
|
|
101
103
|
var LEGACY_SANDBOX_COMMAND_NAME = "rlm";
|
|
102
104
|
var ORCHESTRATOR_COMMAND_NAME = "snipara-orchestrator";
|
|
103
105
|
var DEVICE_CLIENT_ID = "create-snipara";
|
|
106
|
+
var EXPERIENCE_GOAL_SECTION = `## Experience Goal
|
|
107
|
+
|
|
108
|
+
The target experience is outcome-first agent work across supported clients:
|
|
109
|
+
Codex, Claude Code, Cursor, Orca, LM Studio-backed local stacks, or another
|
|
110
|
+
MCP-capable environment. The user should be able to state an outcome, ask for
|
|
111
|
+
engineering judgment, or request a release while the agent handles Snipara
|
|
112
|
+
context retrieval, workflow state, verification, package checks, Git operations,
|
|
113
|
+
deployment, and production smoke checks behind the scenes. Surface important
|
|
114
|
+
decisions, blockers, and evidence, but do not make the user manually orchestrate
|
|
115
|
+
routine Snipara or release mechanics.`;
|
|
116
|
+
var UNIVERSAL_CLIENT_GUIDANCE = "The target experience is outcome-first: the user can ask for engineering judgment or a release, and the agent should use Snipara context, workflow state, verification, package checks, Git, deploy, and smoke checks without making the user orchestrate routine mechanics.";
|
|
104
117
|
var DeviceAuthorizationAborted = class extends Error {
|
|
105
118
|
};
|
|
106
119
|
var AI_CLIENT_CHOICES = [
|
|
@@ -1414,6 +1427,8 @@ This project uses Snipara Hosted MCP for project context and reviewed memory.
|
|
|
1414
1427
|
\`snipara-companion task-commit\` as the reliable local fallback, then restart
|
|
1415
1428
|
or reload Codex after MCP config changes.
|
|
1416
1429
|
|
|
1430
|
+
${EXPERIENCE_GOAL_SECTION}
|
|
1431
|
+
|
|
1417
1432
|
Agent task lifecycle:
|
|
1418
1433
|
|
|
1419
1434
|
1. Start every new thread by validating hosted MCP availability, then use
|
|
@@ -1479,6 +1494,9 @@ Use Snipara Hosted MCP before answering project-specific questions.
|
|
|
1479
1494
|
|
|
1480
1495
|
- Endpoint: \`${buildHostedMcpEndpoint(answers)}\`
|
|
1481
1496
|
- If a session exposes only a subset of expected Snipara tools, call \`snipara_help(list_all=true)\` before concluding a tool is unavailable.
|
|
1497
|
+
|
|
1498
|
+
${EXPERIENCE_GOAL_SECTION}
|
|
1499
|
+
|
|
1482
1500
|
- Start substantial work with \`snipara_recall\` and a targeted \`snipara_context_query\`.
|
|
1483
1501
|
- Use \`snipara_context_query\` for source truth and \`snipara_get_chunk\` for exact cited sections.
|
|
1484
1502
|
- When \`snipara_context_query\` returns \`answer_pack\`, use its facts, caveats, source map, and verification checklist before drafting claims.
|
|
@@ -1510,6 +1528,9 @@ This workspace uses Snipara Hosted MCP for current project context, business/cli
|
|
|
1510
1528
|
- Check the configured Snipara MCP server before answering project-specific questions.
|
|
1511
1529
|
- If a session exposes only a subset of expected Snipara tools, call \`snipara_help(list_all=true)\` before concluding a tool is unavailable.
|
|
1512
1530
|
- Endpoint: \`${buildHostedMcpEndpoint(answers)}\`
|
|
1531
|
+
|
|
1532
|
+
${EXPERIENCE_GOAL_SECTION}
|
|
1533
|
+
|
|
1513
1534
|
- Use \`snipara_recall\` for durable decisions, preferences, and validated learnings.
|
|
1514
1535
|
- Use \`snipara_context_query\` for docs, business context, current client/project truth, and narrative source material.
|
|
1515
1536
|
- When \`snipara_context_query\` returns \`answer_pack\`, use its facts, caveats, source map, and verification checklist before drafting claims.
|
|
@@ -2497,7 +2518,7 @@ async function createCompanionPack(answers) {
|
|
|
2497
2518
|
console.log(chalk.bold("\n\u{1F5C2}\uFE0F Generating Companion Pack\n"));
|
|
2498
2519
|
const packDir = path.join(process.cwd(), ".snipara", "companion");
|
|
2499
2520
|
const commands = getCompanionCommands(answers);
|
|
2500
|
-
const guidance = getClientGuidance(answers.aiClient);
|
|
2521
|
+
const guidance = [UNIVERSAL_CLIENT_GUIDANCE, ...getClientGuidance(answers.aiClient)];
|
|
2501
2522
|
const detection = detectEnvironment();
|
|
2502
2523
|
const clientPackFilename = getClientPackFilename(answers.aiClient);
|
|
2503
2524
|
fs.mkdirSync(packDir, { recursive: true });
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-snipara",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.1",
|
|
4
4
|
"description": "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|
|
@@ -35,6 +35,8 @@
|
|
|
35
35
|
"windsurf",
|
|
36
36
|
"gemini",
|
|
37
37
|
"mistral",
|
|
38
|
+
"orca",
|
|
39
|
+
"lm-studio",
|
|
38
40
|
"vscode",
|
|
39
41
|
"continue",
|
|
40
42
|
"claude-desktop"
|