@x1aoye/conflux-oc 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x1aoye
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# Conflux-OC
+
+Auto-learning plugin for [opencode](https://opencode.ai) — cross-session project/machine/user context memory. From message 1, the model knows your OS, toolchain versions, project structure, and knowledge routing rules.
+
+## Installation
+
+```bash
+opencode plugin @x1aoye/conflux-oc@latest --global
+```
+
+Or add to your `opencode.json`:
+
+```json
+{ "plugin": ["@x1aoye/conflux-oc"] }
+```
+
+## What It Does
+
+### Session Context Injection (noReply)
+On every new session, Conflux silently injects:
+
+- **Platform**: OS, shell, CPU architecture
+- **Machine**: Available dev toolchains (java/go/node/python) with versions and paths
+- **Project**: Languages, runtime versions, build/test commands, git branch
+- **User**: Output preferences (language, verbosity, comment style)
+- **Knowledge Rules**: How to record and route discovered knowledge
+
+### Version Switching
+Automatically prepends `export JAVA_HOME=...` before build/run commands based on `runtime-requirements.yaml`.
+
+### Knowledge Management
+- **`note_discovery`** tool: Model records architecture decisions, branch progress, toolchain info
+- **`get_machine_context`** tool: Query specific toolchain domain details
+- **Knowledge routing**: Core architecture → `_shared/` (cross-branch); branch progress → `SKILL.md`
+- **Decision logging**: Automatically creates timestamped decision logs on substantive SKILL.md changes
+- **Archive management**: Old skill variants preserved in `_archive/`
+
+### Migration Tracking
+- Scans `Migration Map` sections in skill files
+- Injects migration hints into session context
+- Alerts when editing files with known migration paths
+
+## Configuration
+
+Conflux searches for config in this order (each level overrides the previous):
+
+1. **Project**: `.opencode/conflux-oc.jsonc`
+2. **Custom**: `$OPENCODE_CONFIG_DIR/conflux-oc.jsonc`
+3. **Global**: `~/.config/opencode/conflux-oc.jsonc`
+4. **Built-in defaults** (always available as fallback)
+
+```jsonc
+// .opencode/conflux-oc.jsonc
+{
+  "layers": [
+    { "name": "platform", "priority": 0, "storage": "transform-only", "inject": "always" },
+    { "name": "machine", "priority": 1, "storage": { "type": "local", "path": "machines/{id}.json" }, "inject": "summary-only" },
+    { "name": "user", "priority": 2, "storage": { "type": "local", "path": "users/{name}.json" }, "inject": "always" },
+    { "name": "project", "priority": 3, "storage": { "type": "local", "path": ".opencode/skills/" }, "inject": "on-demand" }
+  ]
+}
+```
+
+## Privacy
+
+- Machine and User profiles stored in `~/.config/opencode/plugins/conflux-oc/` (never in git)
+- Blocks read access to `.env`, `.ssh/`, `.gnupg/`, and sensitive files
+- Filters sensitive content (private keys, tokens, secrets) from knowledge recording
+- Project skills stored in `.opencode/skills/` (in git, team-shareable)
+
+## License
+
+MIT

package/dist/audit/archive-manager.d.ts

@@ -0,0 +1,4 @@
+import type { ChangeInfo } from "./change-detector.js";
+export declare function createDecisionLog(filePath: string, change: ChangeInfo): string | null;
+export declare function archiveOldVariant(filePath: string, change: ChangeInfo): string | null;
+export declare function updateMigrationMap(filePath: string, oldName: string, newName: string): void;

package/dist/audit/change-detector.d.ts

@@ -0,0 +1,10 @@
+export interface ChangeInfo {
+    isSubstantial: boolean;
+    oldName: string | null;
+    newName: string | null;
+    oldHeadings: string[];
+    newHeadings: string[];
+    linesAdded: number;
+    linesRemoved: number;
+}
+export declare function analyzeChange(oldContent: string | null, newContent: string, filePath: string): ChangeInfo;

package/dist/audit/migration-map.d.ts

@@ -0,0 +1,8 @@
+export interface MigrationEntry {
+    oldPath: string;
+    newApi: string;
+    sourceFile: string;
+}
+export declare function parseAllMigrationMaps(skillsDir: string): MigrationEntry[];
+export declare function findMigrationMatch(filePath: string, entries: MigrationEntry[]): MigrationEntry | null;
+export declare function formatMigrationHints(entries: MigrationEntry[]): string;

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+export interface LayerConfig {
+    name: string;
+    priority: number;
+    storage: string | {
+        type: string;
+        path: string;
+    };
+    inject: "always" | "summary-only" | "on-demand";
+}
+export interface BehaviorRule {
+    id: string;
+    trigger: string;
+    rule: string;
+    condition?: string;
+    enabled: boolean;
+}
+export interface PluginConfig {
+    layers: LayerConfig[];
+    behavior_rules: BehaviorRule[];
+}
+export interface ResolvedStorage {
+    type: "none" | "local";
+    basePath: string;
+    template: string;
+}
+export interface ResolvedPluginConfig {
+    layers: LayerConfig[];
+    behavior_rules: BehaviorRule[];
+    pluginDataDir: string;
+    projectRoot: string;
+    resolvedStorages: Record<string, ResolvedStorage>;
+}
+export declare function resolvePluginDataDir(): string;
+export declare function loadPluginConfig(projectRoot?: string): PluginConfig;
+export declare function resolvePluginConfig(projectRoot?: string): ResolvedPluginConfig;
+export declare function getEnabledRules(config: PluginConfig): BehaviorRule[];

package/dist/detection/language.d.ts

@@ -0,0 +1,2 @@
+export declare function detectSystemLanguage(): string;
+export declare function languageInstruction(lang?: string): string;

package/dist/detection/machine-id.d.ts

@@ -0,0 +1,6 @@
+export interface MachineIdentity {
+    id: string;
+    method: "dmi" | "machine-id" | "hostname-mac";
+}
+export declare function identifyMachine(): MachineIdentity;
+export declare function sanitizeId(id: string): string;

package/dist/detection/platform.d.ts

@@ -0,0 +1,6 @@
+export interface PlatformInfo {
+    os: string;
+    shell: string;
+    arch: string;
+}
+export declare function detectPlatform(): PlatformInfo;

package/dist/detection/project.d.ts

@@ -0,0 +1,14 @@
+export interface RuntimeRequirement {
+    version: string;
+    source?: string;
+    switching?: string;
+}
+export interface ProjectRuntime {
+    languages: string[];
+    versions: Record<string, string>;
+    build: string;
+    test: string;
+}
+export declare function runtimeRequirementsPath(projectRoot: string): string;
+export declare function readRuntimeRequirements(projectRoot: string): Record<string, RuntimeRequirement> | null;
+export declare function detectProjectRuntime(projectRoot: string): ProjectRuntime;

package/dist/detection/toolchain.d.ts

@@ -0,0 +1,16 @@
+export interface ToolchainEntry {
+    path: string;
+    version: string;
+}
+export interface ToolchainDomain {
+    paths: Record<string, string>;
+    versions: Record<string, string>;
+    extras?: Record<string, string>;
+}
+export interface ToolchainResult {
+    java: ToolchainDomain | null;
+    go: ToolchainDomain | null;
+    node: ToolchainDomain | null;
+    python: ToolchainDomain | null;
+}
+export declare function detectToolchain(): Promise<ToolchainResult>;

package/dist/hooks/file-edited.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedPluginConfig } from "../config.js";
+import type { LayerRegistry } from "../layers/registry.js";
+export declare function createFileEditedHandler(config: ResolvedPluginConfig, _registry: LayerRegistry): (input: any, _output: any) => Promise<void>;

package/dist/hooks/session-created.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedPluginConfig } from "../config.js";
+import type { LayerRegistry } from "../layers/registry.js";
+export declare function createSessionCreatedHandler(client: any, config: ResolvedPluginConfig, _registry: LayerRegistry): (input: any, _output: any) => Promise<void>;

package/dist/hooks/tool-execute-before.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedPluginConfig } from "../config.js";
+import type { LayerRegistry } from "../layers/registry.js";
+export declare function createToolExecuteBeforeHandler(config: ResolvedPluginConfig, _registry: LayerRegistry): (input: any, output: any) => Promise<void>;

package/dist/i18n/en.d.ts

@@ -0,0 +1,2 @@
+declare const en: Record<string, string>;
+export default en;

package/dist/i18n/index.d.ts

@@ -0,0 +1 @@
+export declare function t(key: string, params?: Record<string, string | number>): string;

package/dist/i18n/zh.d.ts

@@ -0,0 +1,2 @@
+declare const zh: Record<string, string>;
+export default zh;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const plugin: Plugin;
+export default plugin;